Sublime Text不能也不需要配置Gradle环境，只需稳定调用./gradlew并正确解析错误行号；它不管理JVM、不解析DSL、不下载依赖，仅作为调用命令行的轻量编辑器。
Sublime Text 不能也不需要“配置 Gradle 环境”——它压根不管理 JVM、不解析 build.gradle 语义、不下载依赖、不启动 daemon。你真正要做的，是让它能**稳定调用 ./gradlew 并正确展示错误行号**。其他全是干扰项。
为什么 ./gradlew 是唯一靠谱的入口
项目级 gradlew 脚本会自动拉取 gradle/wrapper/gradle-wrapper.properties 中声明的版本，避免和你本地 gradle -v 输出的版本冲突。Android 项目尤其敏感：AGP 8.4 要求 Gradle 8.6，用错版本直接卡在 Could not initialize class org.jetbrains.kotlin.gradle.internal.KotlinSourceSetKt。
- 如果项目没提交
gradlew和gradlew.bat，说明它默认依赖全局环境——这时必须手动核对buildscript.classpath里 AGP 版本与 Gradle 版本的[官方映射表](https://developer.android.com/studio/releases/gradle-plugin#compatibility-versions) - Windows 用户别写
./gradlew，得用gradlew.bat；macOS/Linux 则必须确保脚本有执行权限：chmod +x gradlew -
./gradlew tasks在终端能跑通，但在 Sublime 里报command not found？大概率是 shell 没加载你的~/.zshrc——加"shell": true通常能救回来
构建系统（.sublime-build）怎么写才不翻车
新建 Tools → Build System → New Build System…，贴入以下内容并保存为 Gradle.sublime-build：
{
"cmd": ["./gradlew", "$1"],
"working_dir": "${project_path:${folder}}",
"selector": "source.java, source.groovy",
"shell": true,
"file_regex": "^(.*?):([0-9]+):([0-9]+):\s*(error|warning)",
"variants": [
{
"name": "Clean",
"cmd": ["./gradlew", "clean"]
},
{
"name": "Build",
"cmd": ["./gradlew", "build"]
}
]
}
-
$1占位符只在cmd字段生效，别误用shell_cmd——后者不支持变量替换 -
file_regex必须匹配 Gradle 的 plain console 输出格式，否则 Ctrl+Click 错误行跳转失效；--console=plain --no-daemon参数要硬塞进 cmd 数组里（如["./gradlew", "--console=plain", "--no-daemon", "$1"]） -
working_dir用${project_path:${folder}}而不是固定路径，否则多根目录项目切换时构建失败
build.gradle 文件还是纯文本？语法高亮失效的真相
不是路径问题，也不是编码问题，是 Sublime 根本没加载 Groovy 语法定义。默认的 XML 语法会把 implementation 'com.google.guava:guava:33.2.1-jre' 当成非法标签报红。
- 用 Package Control 安装
Gr8插件（不是旧版Groovy，更不是已停更的sublime-gradle） - 安装后重启 Sublime，打开
build.gradle，右下角点击 “Plain Text” → 选Gr8/Groovy - 检查
Preferences → Settings – Syntax Specific是否残留"syntax": "Packages/XML/XML.tmLanguage"，删掉它 -
build.gradle.kts是 Kotlin DSL，Gr8不支持——得靠Kotlin插件 + 手动绑定语法，且无法高亮android {}块内的 DSL
Ctrl+B 按下去只有 [Finished] 或一堆乱码路径？排查顺序
这不是 Gradle 报错，是 Sublime 解析输出失败。优先看三件事：
- 终端进项目根目录执行
./gradlew build --console=plain --no-daemon，确认能输出带行号的错误（如app/build.gradle:42:17: error: …） - 检查
.sublime-build里的file_regex是否和实际输出格式一致；Gradle 6.0+ 默认用:分隔路径和行号，老正则^(.*?):([0-9]+):可能漏掉列号 - 如果输出里路径含空格（如
/Users/name/My Project/app/build.gradle），某些旧版 Gr8 会 fallback 到 Plain Text —— 临时改路径测试，或升级 Gr8 到最新版
ANDROID_SDK_ROOT 还是 JAVA_HOME，也不会提示 compileSdkVersion 34 找不到——它只负责把命令行输出原样扔给你。真正关键的，永远是你自己在终端里验证过的那条 ./gradlew 命令。 
