sublime text 不需配置 gradle 环境，只需正确设置构建系统：确保 ./gradlew 有执行权、working_dir 指向项目根、file_regex 匹配错误格式；android 项目还需匹配 agp 与 gradle 版本、设置 android_sdk_root、安装 gr8 插件识别 build.gradle 语法。
Sublime Text 不能也不需要“配置 Gradle 环境”——它只调用 ./gradlew 或 gradlew.bat，关键在于构建系统能否在正确路径、用正确参数、解析出可跳转的错误行。
为什么 ./gradlew 在终端能跑，Sublime 却报 command not found
Sublime 启动时默认不加载你的 shell 初始化文件（如 ~/.zshrc），所以即使 gradle -v 在终端可用，它的构建进程仍可能找不到命令或执行权限。
- macOS/Linux：确认
gradlew在项目根目录且有执行权：chmod +x gradlew - Windows：必须用
gradlew.bat，不是./gradlew；检查该文件是否存在 - 加
"shell": true让 Sublime 复用当前用户 shell 环境（但注意：它不保证加载~/.zprofile） - 若仍失败，改用绝对路径，例如
"/Users/you/project/gradlew"，避免工作目录解析歧义
Gradle.sublime-build 必须写的三个字段
一个可用的构建系统不是靠插件自动生成的，而是手动写对这三项：
-
"cmd": ["./gradlew", "$1"]：占位符$1只在cmd数组中生效；别误用shell_cmd，它不解析变量 -
"working_dir": "${project_path:${folder}}"：确保./gradlew在项目根目录执行，否则 wrapper 找不到gradle/wrapper/gradle-wrapper.properties -
"file_regex": "^(.*?):([0-9]+):([0-9]+):\s*(error|warning)"：匹配 Gradle 默认 plain 输出格式；不加这个，双击错误行无法跳转到源码
Android 项目构建失败的常见硬伤
AGP 对 Gradle 版本极其敏感，错一个数字就卡在 Could not initialize class org.jetbrains.kotlin.gradle.internal.KotlinSourceSetKt。
- 优先用项目自带的
./gradlew，它会按gradle/wrapper/gradle-wrapper.properties中的distributionUrl自动拉取指定版本 - 如果项目没提交
gradlew和gradlew.bat，说明它依赖全局环境——此时必须查 AGP 与 Gradle 版本映射表，手动核对buildscript.classpath里的 AGP 版本和本地gradle -v输出是否匹配 - Android 构建还需
ANDROID_HOME或ANDROID_SDK_ROOT环境变量，Sublime 不自动继承；若报 SDK 相关错误，得在构建系统里显式加"env": {"ANDROID_SDK_ROOT": "/path/to/sdk"}
build.gradle 文件还是白底黑字？
这不是 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 插件并手动绑定语法
最常被忽略的一点：./gradlew 能否成功运行，和 Sublime 无关；它只是个通道。真正卡住的地方，永远在 wrapper 配置、AGP 版本、SDK 路径或语法文件绑定上——而不是“没配好构建系统”。
