Sublime Text 需通过自定义构建系统调用 Gradle 命令，关键在于确保终端可执行 gradle、配置正确 PATH、使用 --console=plain --no-daemon 参数并设置匹配 Gradle 错误格式的 file_regex。
Sublime Text 本身不内置 Gradle 支持，也不能直接“配置 Gradle 环境”——它只是个编辑器，真正执行构建的是你本地安装的 Gradle 命令行工具。关键不是改 Sublime 的设置，而是让 Sublime 能正确调用 gradle 命令，并把输出结果清晰地展示出来。
确认 gradle 命令在终端可用
这是最常卡住的第一步。Sublime 的构建系统默认继承系统的 PATH，如果终端里输 gradle -v 报 command not found，Sublime 也一定找不到。
- macOS / Linux：检查
~/.gradle/wrapper/dists/是否存在，再确认PATH是否包含 Gradle 的bin目录（比如/opt/gradle/bin或 SDKMAN 安装路径） - Windows：检查环境变量
Path是否包含gradlein，注意不要漏掉.bat后缀导致命令识别失败 - 推荐用 SDKMAN（macOS/Linux）或 Gradle Wrapper（
./gradlew）替代全局安装，避免权限和版本冲突
创建自定义构建系统：支持 gradle build 和 gradlew
Sublime 的构建系统本质是 JSON 配置，告诉它该跑什么命令、工作目录在哪、怎么解析错误。别用默认的 Java Builder（它只认 javac），要自己写。
- 菜单栏 → Tools → Build System → New Build System…
- 粘贴以下内容（适配 macOS/Linux；Windows 用户把
shell_cmd改成gradlew.bat build，并确保working_dir正确）：
{
"shell_cmd": "gradle build",
"working_dir": "${project_path:${folder}}",
"file_regex": "^\s*([^s]+):([0-9]+):?([0-9]+)?:?\s*(.*)$",
"selector": "source.java",
"variants": [
{
"name": "Build with Wrapper",
"shell_cmd": "./gradlew build",
"working_dir": "${project_path:${folder}}"
}
]
}
保存为 Gradle.sublime-build。之后在 Tools → Build System 下就能选到它。
立即学习“Java免费学习笔记（深入）”；
为什么 gradle build 输出一堆日志却看不到错误行？
默认构建系统把所有输出当普通文本，无法跳转到报错文件和行号。关键是 file_regex 要匹配 Gradle 的实际错误格式——但 Gradle 默认输出是分层、带颜色、含前缀的，正则根本抓不住。
- 加
--console=plain --no-daemon参数压制干扰项："shell_cmd": "gradle build --console=plain --no-daemon" - Gradle 7+ 错误行典型格式是：
path/to/File.java:42: error: cannot find symbol，所以file_regex必须能提取出文件路径、行号、列号和消息 - 如果项目用了 Lombok 或 annotation processor，错误可能藏在
build/generated/下，这时需要额外配置paths或改用./gradlew compileJava --stacktrace定位
运行测试或执行特定 task 怎么办？
Gradle 构建系统不是只能跑 build。你可以通过 variants 快速切换常用命令，不用反复改 JSON。
- 在上面的
variants数组里追加： "name": "Test", "shell_cmd": "./gradlew test --console=plain"-
"name": "Run", "shell_cmd": "./gradlew run --console=plain"（需application插件） - 按
Ctrl+Shift+P（macOS 是Cmd+Shift+P），输入Build With就能快速选择
复杂点在于：Gradle 的 run 默认不输出控制台交互内容，需要在 build.gradle 里显式配置 standardInput = System.in，否则 Sublime 的输出面板里敲不了输入。
