build.gradle文件被识别为纯文本，主因是Sublime未安装Gr8语法包或存在语法插件冲突；需通过Package Control安装Gr8、清除Settings–Syntax Specific中残留的XML语法配置，并确保无其他Groovy插件干扰。
build.gradle 文件为什么还是纯文本？
Sublime 默认不识别 build.gradle 文件，状态栏显示 “Plain Text” 或 “XML”，说明语法定义没加载。这不是路径或编码问题，是根本没装对应语法包。
别用系统自带的 XML 语法强行打开——它会把 implementation、plugins 当成标签名标红，完全不可读。
- 用 Package Control 安装
Gr8（不是旧版Groovy，也不要用sublime-gradle这类已停更项目） - 安装后重启 Sublime，打开任意
build.gradle，右下角点击语法名 → 选Gr8/Groovy - 若仍无效，检查
Preferences → Settings – Syntax Specific是否残留"syntax": "Packages/XML/XML.tmLanguage"，删掉它
Gradle DSL 关键字（如 plugins、dependencies）不着色怎么办？
Gr8 支持 plugins { id 'java' }、dependencies { implementation ... } 等 DSL 关键字高亮，但前提是文件被正确识别为 Groovy 类型，且没有被其他插件劫持。
常见干扰项：
- 装了多个 Groovy 相关插件（比如同时有
Groovy和Gr8），导致语法规则冲突，关键字忽亮忽暗 -
build.gradle.kts是 Kotlin DSL，Gr8不支持——它只管.gradle，.kts得靠 Kotlin 插件 + 手动绑定语法 - 文件路径含空格或特殊字符（如
My Project/build.gradle），某些旧版Gr8会 fallback 到 Plain Text
配置构建系统时，$1 占位符为什么不生效？
你写了 "cmd": ["./gradlew", ""]，按 Ctrl+B 后输 build 却报错 command not found: ，说明 Sublime 没解析占位符——这通常是因为用了 shell_cmd 字段而非 cmd。
必须严格匹配字段语义：
-
cmd：传数组，不走 shell，支持$1占位符，但 Windows 下需确保./gradlew可执行（Linux/macOS 正常，Windows 要用gradlew.bat） -
shell_cmd：传字符串，走 shell，不支持$1，只能写死命令如"./gradlew build" - 加
"shell": true可让cmd数组在 shell 环境中执行，解决 PATH 继承问题，但不会让shell_cmd突然支持占位符
Android 项目里 local.properties 缺失导致构建失败
Sublime 调 ./gradlew assembleDebug 报错：Could not find method android() for arguments [...] on project ':app' of type org.gradle.api.Project. 或更直接的 ANDROID_HOME is not set，大概率是缺 local.properties。
这个文件一般不提交 Git，但 Sublime 构建时又必须它：
- 手动在项目根目录创建
local.properties - 内容只两行（路径按你本地 SDK 实际位置填）：
sdk.dir=/Users/you/Library/Android/sdk<br>ndk.dir=/Users/you/Library/Android/sdk/ndk/25.1.8937393
- macOS/Linux 用户注意：GUI 启动的 Sublime 不继承终端里的
export ANDROID_HOME=...，必须显式写进local.properties，不能依赖环境变量
Gradle 构建脚本高亮只是表层，真正卡住人的永远是环境链：语法包 → wrapper 可执行性 → Android SDK 路径 → JVM 版本匹配。其中 local.properties 和 gradlew 的存在性，比任何语法设置都优先。
