Sublime调用不了javac或java,90%是系统JDK未配好;先确保终端中javac -version和java -version成功,再检查JAVA_HOME、PATH、包路径、编码(UTF-8)、依赖配置等。

Sublime 调用不了 javac 或 java,90% 是系统级 JDK 没配好,不是 Sublime 配置错了。先在终端里跑通 javac -version 和 java -version,否则后面所有构建系统都白搭。
javac -version 报错?先别碰 Sublime 配置文件
这是最常被跳过的硬前提。Sublime 不自带编译器,只调用你系统 PATH 里的命令。如果终端里 javac -version 失败,Sublime 的构建系统一定失败——它根本看不到 javac。
- Windows:检查
JAVA_HOME是否指向 JDK 根目录(如C:\Program Files\Java\jdk-17.0.1),且%JAVA_HOME%\bin已加进系统PATH;只装了 JRE 会通过java -version但卡在javac - macOS:用
brew install openjdk@17后,确认/opt/homebrew/opt/openjdk@17/bin在$PATH里;which javac必须有输出 - Linux:安装的是
openjdk-17-jdk(不是-jre),再执行sudo update-alternatives --config java和--config javac确保两者指向同一版本 - 改完环境变量后,必须彻底退出 Sublime 进程(macOS 右键 Dock 图标 → Quit;Windows 任务管理器杀
subl.exe),否则它仍读旧环境
运行报 “Error: Could not find or load main class”
这不是代码写错了,是 java 命令没找对类路径或类名。关键在于:类名 ≠ 文件名,而取决于 package 声明和工作目录结构。
- 如果源码第一行是
package com.example;,文件就必须放在com/example/HelloWorld.java,且构建时working_dir必须设为com的上一级目录(即包含com/的那个目录) - 构建命令里不能用
java "$file_base_name"直接运行带包的类;得用完整类名,比如java com.example.HelloWorld,且此时working_dir得是com的父目录 - 默认
JavaC.sublime-build不加-d .参数,javac会把.class全塞进当前目录,破坏包结构;必须显式加上"shell_cmd": "javac -d . \"$file\" && java \"$file_base_name\"" - 如果不想折腾包路径,最简做法:删掉所有
package行,把.java文件全放在项目根目录,用working_dir: "$file_path"即可
中文乱码、编译报 “非法字符” 怎么办
Windows 下尤其典型,本质是三处编码不一致:Sublime 文件保存编码、javac 读源码用的编码、控制台输出解码用的编码。三者只要一个错位,就出方块或问号。
分析 Java Spring Boot 后端 Controller 代码,自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- Sublime 右下角确认文件编码是
UTF-8(不是UTF-8 with BOM);如果不是,点它 →Reopen with Encoding→UTF-8,再Save with Encoding→UTF-8 - 构建命令里必须加
-encoding UTF-8,否则 Windows 上javac默认用 GBK 解码 UTF-8 源文件,直接报错“非法字符” - 控制台输出乱码:Windows 用户可在
shell_cmd前加chcp 65001 > nul &&(注意&&是转义后的&),强制 CMD 切到 UTF-8 模式 - macOS/Linux 一般无此问题,但若用了非系统默认 shell(如 zsh 配了特殊 locale),也要检查
locale输出是否含UTF-8
为什么 JavaC 插件跑不起来带依赖的项目
因为 JavaC 插件(r-stein 版)只做单文件编译,不处理 -cp、不解析 pom.xml、也不支持通配符 *.jar。它本质是个快捷按钮,不是构建工具。
- 想加 jar 依赖,得手动改构建系统的
shell_cmd,例如:"javac -cp \".;lib/*\" -encoding UTF-8 \"$file\" && java -cp \".;lib/*\" \"$file_base_name\""(Windows) - macOS/Linux 要把分号
;换成冒号:,且通配符lib/*在某些 shell 下需展开,可能得写成lib/a.jar:lib/b.jar - 一旦项目有多个源文件、跨包引用、资源文件(如
resources/),JavaC 插件完全失效;这时应转向javac+java手动命令,或换用 VS Code + Extension Pack for Java - Sublime 从不读取项目配置文件(
build.gradle、pom.xml),所谓“自动识别 Maven 项目”纯属误解
真正卡住人的从来不是 JSON 写法,而是 javac 对包路径的绝对要求、Windows 控制台的编码 Legacy、以及误以为 Sublime 能替代 IDE 的预期。把 javac -version 和文件路径匹配这两件事盯死,剩下都是可调的参数。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










