sublime text 不需配置 gradle 环境，只需正确调用项目自带的 ./gradlew 或 gradlew.bat；构建失败多因路径、语法高亮或占位符使用不当，而非 sublime 配置问题。
Sublime Text 不能也不需要“配置 Gradle 环境”——它不管理 JVM、不解析 build.gradle DSL、不调用 Android SDK 工具链，只负责调用项目自带的 ./gradlew（Linux/macOS）或 gradlew.bat（Windows）并展示输出。你看到的构建失败、路径错误、乱码或“[Finished]”空结果，几乎都源于构建系统没对准项目上下文，而不是 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） - 在
.sublime-build中显式设"shell": true，让 Sublime 复用当前用户的 shell 环境（但注意：这不保证加载~/.zprofile） - 若仍失败，改用绝对路径，例如
"/Users/you/project/gradlew"，避免路径解析歧义
build.gradle 文件仍是 Plain Text，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不支持——需单独安装Kotlin插件，并手动绑定语法
Ctrl+B 构建时输 assembleDebug 没反应，或报错说参数未传入
这是因为构建定义里用了 shell_cmd 字段，而占位符只在 cmd 字段中生效；shell_cmd 把整个字符串当 shell 命令执行，不解析占位符。
- 必须用
"cmd": ["./gradlew", "$1"]，而非"shell_cmd": "./gradlew $1" - Windows 用户记得把
./gradlew换成gradlew.bat，且确认该文件存在 -
"working_dir": "${project_path:${folder}}"必须设置，否则./gradlew在错误路径下执行，找不到 wrapper - 加
--console=plain --no-daemon参数可避免 ANSI 转义符干扰和 daemon 状态冲突
最容易被忽略的一点是：./gradlew 的执行前提是项目根目录下确实存在该文件，且其 gradle/wrapper/gradle-wrapper.properties 中的 distributionUrl 可达。Sublime 不会帮你下载 Gradle、不校验 JDK 版本、也不提示 ANDROID_HOME 缺失——它只忠实地执行命令，然后把 stdout/stderr 原样吐出来。
