sublime text 运行 java 依赖系统已安装并正确配置的 jdk,必须确保终端中 javac 和 java 命令可用且版本一致;macos/linux 需验证 path 包含 $java_home/bin,windows 需将 %java_home%in 加入系统 path;sublime 不自动加载 shell 配置或 java_home,修改后需彻底重启;推荐用 javac 插件快速编译单文件(无 package 场景),但涉及 package、多类或标准输入时须手动创建 java.sublime-build 构建系统,关键参数为 "-d ." 和 "working_dir": "${file_path}",并严格保证源文件路径与 package 声明一致,否则易出现 noclassdeffounderror。

Sublime Text 本身不带 Java 编译器或 JVM,所有“运行 Java”动作都只是调用你系统里已装好的 javac 和 java 命令——如果终端里 javac -version 都报错,Sublime 绝对跑不通。
终端能执行 javac 和 java 是硬前提
这不是可选项,是启动前必须验证的步骤。Sublime 启动时只继承操作系统当前环境变量,不会读 JAVA_HOME,也不会加载你的 ~/.zshrc 或 Windows 用户变量。
- macOS/Linux:打开终端,运行
which javac和javac -version,两个都必须有输出,且版本号一致(比如都是17.0.2);若which javac无输出,检查$JAVA_HOME/bin是否在$PATH中,并确认 shell 配置文件已生效 - Windows:打开 CMD,运行
where javac和javac -version;没输出说明%JAVA_HOME%in没进系统 Path——光设JAVA_HOME不够,必须手动加进 Path 变量 - 改完环境变量后,必须彻底退出 Sublime(任务管理器杀进程 / macOS 强制 Quit),再重开;否则它根本看不到新 PATH
- macOS 图形界面启动的 Sublime 常不继承 shell 环境,推荐用终端执行
open -a "Sublime Text"或装好subl后用它启动
用 JavaC 插件快速编译单文件(无 package 场景)
适合刷算法、写小工具、不涉及多类引用或包结构的场景。它不处理类路径、不支持 System.in 交互输入,但上手最快。
Java JDK 25 来自 OpenJDK 官方归档,版本为 JDK 25,本条下载地址已指向官方 Windows x64 zip 安装包直链,适合调试旧项目或兼容旧版 Java 运行环境。
- 通过 Package Control 安装插件时搜
JavaC(作者 r-stein),别选已过时的Java或SublimeJava - 安装后打开
.java文件,按Ctrl+B(Windows/Linux)或Cmd+B(macOS)即可编译并自动运行 - 它默认把
.class输出到源文件同目录,所以如果类写了package com.example;,就必须把文件放在com/example/Hello.java,否则报error: class Hello is public, should be declared in a file named Hello.java - 遇到
cannot find symbol,基本是引用了其他类但插件没处理——这种场景就得换手动构建系统
手动创建 Java.sublime-build 支持 package 和运行
一旦用了 package、多个类、或需要标准输入,就必须自己写构建系统。核心是控制 javac -d 输出位置和 java 的工作目录与类名拼写,三者必须严格对齐。
- 菜单栏 →
Tools→Build System→New Build System… - 替换全部内容为以下 JSON(注意 Windows 路径用双反斜杠,macOS/Linux 用正斜杠):
{ "cmd": ["javac", "-encoding", "UTF-8", "-d", ".", "$file"], "file_regex": "^.*?([A-Za-z0-9_$.]+)\.java:([0-9]+):?([0-9]+):?\s*(.*)$", "selector": "source.java", "encoding": "UTF-8", "variants": [ { "name": "Run", "shell": true, "cmd": ["java", "${file_base_name}"], "working_dir": "${file_path}", "encoding": "UTF-8" } ] } -
-d .是关键:它让javac按包名自动创建子目录(如package com.example;→ 输出./com/example/MyClass.class),java才能按约定路径找到类 -
"working_dir": "${file_path}"必须写,否则java在错误目录下执行,找不到.class文件 - 保存为
Java.sublime-build(不要加C或Run后缀),右下角状态栏手动切换构建系统为Java,再按Ctrl+Shift+B→Run
javac 找得到但运行报 NoClassDefFoundError?检查这三点
这类错误表面是类找不到,实际几乎全是路径错位导致的,不是代码问题。
- 源文件路径是否匹配
package声明:如package com.example;,文件必须放在com/example/Hello.java,不能是Hello.java平铺在项目根目录 -
javac -d参数是否用了.:用-d "${file_path}"会导致 class 被写进源文件同级目录,但 package 层级缺失,java仍按包结构去找,必然失败 -
java命令是否用了全限定类名:如果类在com.example包下,运行时得用java com.example.Hello,但 Sublime 构建系统里${file_base_name}只取文件名,所以必须确保文件路径与包结构完全对齐,才能用这个变量
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










