Sublime Text不能也不需要配置Gradle环境，仅调用项目自带的./gradlew或gradlew.bat；问题多因构建系统未对准项目上下文，如shell环境未加载、working_dir错误、file_regex不匹配或语法高亮缺失。
Sublime Text 不能也不需要“配置 Gradle 环境”——它只调用 ./gradlew 或 gradlew.bat，出问题基本是因为构建系统没对准项目上下文，不是 Sublime 本身有缺陷。
为什么 ./gradlew 在终端能跑，Sublime 里却报 command not found
Sublime 的构建进程默认不加载你的 shell 初始化文件（比如 ~/.zshrc），所以即使 gradle -v 在终端可用，Sublime 仍可能找不到命令。这不是路径没配对，是环境没带进来。
- 优先用项目自带的
./gradlew（macOS/Linux）或gradlew.bat（Windows），它不依赖全局PATH，且自动匹配gradle/wrapper/gradle-wrapper.properties中声明的版本 - 确保
gradlew文件在项目根目录下可执行：macOS/Linux 执行chmod +x gradlew；Windows 用户确认gradlew.bat存在且没被 Git 忽略 - 在
.sublime-build中显式设"shell": true，让 Sublime 复用当前用户的 shell 环境（注意：这不保证加载~/.zprofile） - 若仍失败，改用绝对路径，例如
"/Users/you/project/gradlew"，避免路径解析歧义
.sublime-build 文件里 $1 占位符不生效
这是最常踩的坑：$1 只在 "cmd" 字段中有效，"shell_cmd" 完全不解析占位符——你输 build，它却把整个字符串当 shell 命令执行，根本不会替换。
- 必须用
"cmd": ["./gradlew", "$1"]，不能写成"shell_cmd": "./gradlew $1" - Windows 用户记得把
./gradlew换成gradlew.bat，否则直接报错 -
"working_dir": "${project_path:${folder}}"必须设置，否则./gradlew在错误路径下执行，找不到settings.gradle或build.gradle - 加
--console=plain --no-daemon到cmd数组里，例如["./gradlew", "--console=plain", "--no-daemon", "$1"]，否则输出含 ANSI 转义符、行号解析失败
build.gradle 还是纯文本，DSL 关键字全没高亮
这不是 Gradle 配置问题，是 Sublime 没识别出该文件该用什么语法。默认 XML 语法会把 implementation 当成非法标签，完全不可读。
- 用 Package Control 安装
Gr8插件（不是旧版Groovy，也不是已停更的sublime-gradle） - 安装后重启 Sublime，打开任意
build.gradle，点击右下角语法名 → 选Gr8/Groovy - 检查
Preferences → Settings – Syntax Specific是否残留"syntax": "Packages/XML/XML.tmLanguage"，删掉它 -
build.gradle.kts是 Kotlin DSL，Gr8不支持——需单独安装LanguageKotlin插件，并手动绑定语法（右下角 →Open all with current extension as…→Kotlin）
构建输出里 Ctrl+Click 错误行跳转失效
这几乎全是 file_regex 没配对导致的。Gradle 默认输出是 rich console 格式，含颜色和缩进，Sublime 解析不了；必须强制 plain 输出，并用正则精准匹配错误行结构。
-
file_regex推荐值："^(.*?):([0-9]+):([0-9]+):\s*(error|warning)"（注意转义冒号和空格） - 这个正则只匹配形如
app/build.gradle:24:5: error: ...的行，不匹配* What went wrong:这类提示 - 务必在
cmd中加入--console=plain --no-daemon，否则日志格式不稳定，正则会漏匹配 - Android 项目常见错误如
Could not initialize class org.jetbrains.kotlin.gradle.internal.KotlinSourceSetKt，本质是 AGP 与 Gradle 版本不匹配，Sublime 不会帮你诊断，只能靠你在终端先跑通./gradlew tasks
真正麻烦的从来不是怎么写 .sublime-build，而是项目本身是否具备可构建前提：有没有 local.properties、ANDROID_HOME 是否就位、gradle-wrapper.properties 里的 distributionUrl 能否访问——Sublime 不会报这些错，它只会静默失败或显示一堆乱码路径。
