Sublime Text 本身不配置 Gradle 环境，仅调用本地或项目自带的 gradlew/gradle 命令；需确保 PATH 正确、使用 --console=plain --no-daemon 参数、设置匹配错误格式的 file_regex，并优先采用 ./gradlew 以保证版本一致。
Sublime Text 本身不配置 Gradle 环境，它只调用你本地已安装或项目自带的 gradlew 或 gradle 命令。真正要做的，是让 Sublime 能在正确路径下、用正确参数、解析正确错误格式地执行构建命令——否则 Ctrl+B 按下去只有“[Finished]”或一堆乱码路径。
Gradle 构建系统为什么总报 command not found
这不是 Sublime 的错，而是它没继承你 shell 里生效的 PATH。终端能跑 gradle -v，不代表 Sublime 能——尤其 macOS/Linux 下用了 zsh、fish 或 SDKMAN，Windows 下用了 PowerShell 配置环境变量，Sublime 启动时往往只读取最简环境。
- 先验证：打开 Sublime →
Ctrl+`打开内置终端（如果装了 Terminal 插件），输入which gradle或./gradlew --version；若失败，说明 PATH 没传进来 - 临时解法：在构建系统里显式加
"path": "/opt/gradle/bin:/usr/local/bin"（macOS/Linux）或"path": "C:\gradle\bin;C:\Users\xxx\scoop\shims"（Windows） - 更稳做法：统一用
./gradlew（Linux/macOS）或gradlew.bat（Windows），它不依赖全局 PATH，且版本与项目gradle/wrapper/gradle-wrapper.properties严格一致 - 别漏
"shell": true—— 否则./gradlew在 Windows 下无法识别，&&连写也会失效
如何写一个可用的 Gradle.sublime-build 文件
核心就三点：命令可执行、工作目录对、错误能跳转。别套用网上千篇一律的 JSON，重点看字段是否匹配你当前项目结构和操作系统。
-
"cmd": ["./gradlew", "$1"]是最灵活写法：$1允许你按 Ctrl+B 后输入build、test或assembleDebug，不用反复改文件 -
"working_dir": "${project_path:${folder}}"必须设，否则./gradlew在子目录里执行会找不到settings.gradle -
"selector": "source.java, source.gradle, source.groovy"决定 Ctrl+B 是否激活该构建系统；没这行，Java 文件里按 Ctrl+B 会默认走 javac 构建 -
"file_regex": "^(.*?):([0-9]+):([0-9]+):(.*)$"让错误行双击直接跳转到源码对应位置；Gradle 默认输出格式兼容这个正则，但加--console=plain --no-daemon更稳定（避免 ANSI 转义符干扰） - Windows 用户必须把
./gradlew换成gradlew.bat，且确保项目根目录真有这个文件；否则报 “The system cannot find the file specified”
为什么推荐 gradlew 而不是全局 gradle
Android 或 Spring Boot 项目对 Gradle 版本极其敏感。gradle build 可能用你本地装的 8.4，但项目要求 8.2——编译直接失败，报错像 Could not initialize class org.gradle.internal.jvm.JvmVersionDetector 这种根本看不出原因的异常。
立即学习“Java免费学习笔记（深入）”；
-
./gradlew会自动检查gradle/wrapper/gradle-wrapper.properties，下载并缓存指定版本（如distributionUrl=https://services.gradle.org/distributions/gradle-8.2-bin.zip） - 团队协作时，所有人用同一 wrapper，避免“在我机器上是好的”类问题
- 如果项目没提交
gradlew，别硬配全局gradle；先运行gradle wrapper生成它，再提交到 Git - 注意权限：Linux/macOS 下
chmod +x gradlew，否则 Sublime 执行时报 “Permission denied”
中文路径、GBK 文件、乱码错误怎么处理
Gradle 本身默认 UTF-8，但 Windows 控制台默认 GBK，javac 编译含中文字符串的 Java 文件时，容易报 非法字符: 'u3000' 或输出中文错误变方块。
- Java 源文件务必用 UTF-8 编码保存：Sublime 右下角点编码 → “Save with Encoding” →
UTF-8 - 在
gradle.properties里加一行：org.gradle.jvmargs=-Dfile.encoding=UTF-8，避免 JVM 读取文件时编码错乱 - 构建系统里加参数：
"cmd": ["./gradlew", "--console=plain", "--no-daemon", "$1"]，关掉富文本输出，减少编码污染 - 如果仍见方块错误，说明 Sublime 控制台渲染有问题——暂时切换终端查看：
Ctrl+`→./gradlew build，以终端真实输出为准
最易被忽略的一点：Sublime 不解析 build.gradle 里的任何 DSL，也不提供依赖跳转或插件补全。你看到的高亮只是语法着色，不是语义支持。别指望它像 IntelliJ 那样 Ctrl+Click 进 implementation，那不属于构建系统的职责范围。
