Sublime中Java构建失败主因是环境变量未继承、工作目录错误、编码不一致及classpath配置不当，需手动指定javac路径、设置working_dir、添加-encoding UTF-8参数并规范classpath分隔符。
Java编译器路径没配对，javac 直接报 command not found
Sublime 本身不带 Java 环境，它只是调用系统已安装的 javac 和 java。如果你在终端能跑 javac -version，但在 Sublime 里按 Ctrl+B 就报错，大概率是 Sublime 没读到你的环境变量。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- Windows 用户确认
JAVA_HOME指向 JDK 根目录（不是 JRE），且%JAVA_HOME%\bin已加进PATH - macOS / Linux 用户注意：Sublime 默认不继承 shell 的
~/.zshrc或~/.bash_profile，得手动指定路径 - 最稳的方式是改 Sublime 的构建系统，显式写死
javac路径，比如 macOS 上填/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home/bin/javac
构建系统里 shell_cmd 写法不对，编译成功但运行失败
很多人抄网上模板，直接用 shell_cmd: javac "$file" && java "$file_base_name"，结果报 Could not find or load main class —— 因为 java 命令默认在当前目录找 class 文件，而 Sublime 构建时工作目录不一定是源文件所在目录。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 必须用
working_dir显式指定为源文件目录："working_dir": "$file_path" -
shell_cmd分两步更可控：javac "$file" && java "$file_base_name"，注意$file_base_name是不含.java的文件名，且要求类名与文件名严格一致 - 如果主类在包里（比如
com.example.Main），不能直接java Main，得切到src目录并用完整类名：java com.example.Main，此时构建系统需额外处理包路径
中文路径或文件名导致 javac 编译乱码
Windows 上用 GBK 编码保存的 Java 文件，在 Sublime 里默认用 UTF-8 读取，再传给 javac，容易出现「非法字符」错误；反过来，javac 输出的中文错误提示在 Sublime 控制台也可能显示为方块。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 统一用 UTF-8 保存 Java 文件（Sublime 右下角点编码 → Save with Encoding → UTF-8）
- 在构建系统中给
javac加参数：-encoding UTF-8，例如：shell_cmd: javac -encoding UTF-8 "$file" - macOS/Linux 一般无此问题；Windows 用户若仍报错，可临时在构建命令前加
chcp 65001 > nul &&切换控制台编码
想支持运行带依赖的 Java 项目，但构建系统卡在 classpath
单文件可以硬编码，但一加 jar 依赖，-cp 参数就容易漏路径分隔符、引号或通配符行为差异。比如 Windows 用 ;，macOS/Linux 用 :，Sublime 构建系统没法自动判断。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 简单依赖：把所有
.jar放同一目录，用通配符（JDK 6+ 支持）：-cp ".;lib/*"（Windows）或-cp ".:lib/*"（macOS/Linux） - 路径含空格必须加双引号：
-cp ".:./lib/my lib.jar"→ 错，应写成-cp ".:./lib/my\ lib.jar"或-cp ".:./lib/'my lib.jar'" - 真要搞复杂项目，别硬刚构建系统 —— 写个
build.sh或build.bat，用shell_cmd调它，比在 JSON 里拼字符串靠谱
Java 构建系统看着就几行配置，但每个字段都卡在环境、编码、路径、classpath 四个维度上。最容易被忽略的是：Sublime 的构建进程和你终端里的 shell 不是一个上下文，别假设它“应该知道”你的 JDK 在哪、当前在哪、文件怎么编码。
