根本原因是Sublime未继承终端生效的环境变量：macOS/Linux下图标启动不读~/.zshrc等配置，Windows下未彻底重启Sublime进程；需在Build System中硬编码javac绝对路径并显式指定-encoding UTF-8和-d参数，同时确保working_dir与package结构匹配。
javac -version 在终端能跑，Sublime 里 Ctrl+B 却报 “command not found”
根本原因不是 Sublime 配置错了，而是它压根没继承你终端里生效的环境变量。macOS/Linux 上改了 ~/.zshrc 或 ~/.bash_profile，但用图标启动 Sublime，它就只读系统默认 PATH；Windows 上改了环境变量却没彻底退出 Sublime 进程，旧进程仍用老 PATH。
验证方法：在终端执行 which javac，记下路径（比如 /usr/lib/jvm/jdk-17.0.1/bin/javac），然后打开 Sublime → Tools → Build System → New Build System…，写死这个绝对路径：
{
"shell_cmd": "/usr/lib/jvm/jdk-17.0.1/bin/javac -encoding UTF-8 \"$file\" && /usr/lib/jvm/jdk-17.0.1/bin/java \"$file_base_name\"",
"working_dir": "$file_path",
"selector": "source.java"
}
保存为 JavaFixed.sublime-build，再手动选中它。比折腾 JAVA_HOME 和 PATH 更快定位问题。
编译成功但运行时报 “Error: Could not find or load main class”
这不是类名写错了，是 java 命令的工作目录或类名格式不对。Sublime 默认用 $file_base_name 当类名，这仅对无 package 声明的单文件有效；一旦写了 package com.example;，就必须：
立即学习“Java免费学习笔记（深入）”；
- 把源文件放在
com/example/Hello.java目录结构下 - 编译时加
-d .参数生成对应层级的.class文件 - 运行时用完整类名（如
com.example.Hello），且working_dir必须是com的父目录
推荐构建配置（适用于带 package 的项目）：
{
"shell_cmd": "javac -encoding UTF-8 -d . \"$file\" && java \"${file_path}/${file_base_name}\"",
"working_dir": "$file_path/../..",
"selector": "source.java",
"file_regex": "^(.*?):([0-9]+):([0-9]+): (.*)$"
}
注意：$file_path/../.. 是硬编码假设你的 .java 在 src/com/example/ 下；实际需按你项目结构调整。
JavaC 插件按 Ctrl+B 没反应或只闪一下
常见于三类情况：文件没保存（Sublime 不编译未保存的缓冲区）、扩展名不是 .java（哪怕只是多了一个空格或隐藏字符）、或构建系统没真正启用。
排查步骤：
- 确认文件已保存，后缀是纯
.java（右下角状态栏应显示 “Java”） - 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入 “Set Syntax: Java”，强制指定语法高亮 - 检查
Tools → Build System是否勾选了 “JavaC” 或你自定义的构建系统——如果显示 “Automatic”，它可能没识别出 Java 文件 - 插件本身不处理依赖，引用了外部 JAR 就会直接失败，此时必须弃用插件，改用自定义
.sublime-build
中文输出乱码或编译时报 “非法字符”
本质是编码不一致：你的 .java 文件用 UTF-8 保存，但 javac 默认按系统 locale 解码源码（Windows 上常是 GBK）。不改系统区域设置，就在构建命令里显式指定：
所有构建配置中必须包含 -encoding UTF-8 参数，例如：
"shell_cmd": "javac -encoding UTF-8 -d . \"$file\" && java \"$file_base_name\""
同时确保 Sublime 自身也用 UTF-8 打开文件：右下角点击编码名 → 选 “UTF-8”；或者在构建配置里加一行 "encoding": "utf-8"（部分旧版 Sublime 可能不识别该字段，优先保证 javac 命令带参数）。
最易被忽略的是：即使配置全对，只要 JDK 版本低于 11，某些 Unicode 字符（如 emoji 或生僻汉字）仍可能触发编译错误；建议用 Eclipse Temurin JDK 17+，兼容性更稳。
