Sublime Text打开.groovy或.build.gradle文件白底黑字，是因为默认未加载Groovy语法定义；需安装Gr8插件、手动切换右下角语法为“Gr8/Groovy”，并绑定扩展名以实现自动识别，同时配置Build System调用gradlew执行任务。
Sublime Text 为什么打开 .groovy 或 build.gradle 文件全是白底黑字？
不是 Sublime 坏了，是它压根没加载 Groovy 语法定义。默认不识别 .groovy、.gradle 甚至 build.gradle 后缀，连关键字（def、implementation）都不会着色。
- 装错插件：搜 “Groovy” 安装老版插件，会导致 Gradle DSL 关键字（如
api、testImplementation）全标红，实际是语法包过时 - 没手动切换语法：即使装了 Gr8，首次打开文件右下角仍显示 “Plain Text”，必须点它 → 选 “Gr8/Groovy” 才生效
- 文件关联被劫持：如果
build.gradle显示成 XML 风格（标签高亮但 DSL 不识别），说明Preferences → Settings – Syntax Specific里残留了"syntax": "Packages/XML/XML.tmLanguage"，删掉即可
如何让 .groovy 和 .gradle 文件自动用 Gr8 语法？
装完 Gr8 插件后，得手动绑定后缀，否则每次打开都要点右下角切换。
- 打开一个
.groovy文件 → 右下角点 “Plain Text” → 选 “Gr8/Groovy” → 再点菜单View → Syntax → Open all with current extension as…→ 确认选中 “Gr8/Groovy” - 同理处理
.gradle：打开任意.gradle文件 → 切换语法为 “Gr8/Groovy” → 执行相同绑定操作 - 注意：不要用
build.gradle这种带前缀的文件名去绑定；Sublime 只认扩展名，所以绑定.gradle就够了
怎么运行 Groovy 脚本或执行 Gradle 任务？
Sublime 没有内置 Groovy 解释器或 Gradle 集成，必须配 Build System，且不能依赖 groovy 命令直跑——环境变量、类路径、依赖管理全得自己兜底。
- 推荐走
gradlew：新建 Build System（Tools → Build System → New Build System），写入：
{
"cmd": ["./gradlew", "$file_base_name"],
"selector": "source.groovy",
"working_dir": "${project_path:${folder}}"
}
-
$file_base_name会把MyScript.groovy当作 task 名传给 Gradle，适合脚本已注册为 task 的场景；若只是想跑单文件，改用groovy命令需确保 PATH 正确，且常因缺少-cp参数报ClassNotFoundException - Gradle 项目下直接用
./gradlew build或./gradlew test更稳，Build System 中 cmd 改为["./gradlew", "build"]即可 - 别指望 Sublime 提供 DSL 补全或跳转：Gr8 只做语法高亮，
dependencies块里的implementation不会提示可用模块，也不支持 Ctrl+Click 跳转
哪些功能 Sublime 做不了，必须换工具？
DSL 结构敏感操作极易出问题，不是配置不到位，而是架构层面不支持。
- 格式化会破坏 DSL：比如把
dependencies { implementation 'x:y:1.0' }格式化成多行后，缩进错位导致 Gradle 解析失败；应禁用所有对.gradle文件的自动格式化（尤其 Prettier、JsPrettier 类插件） - 无法解析项目依赖图：
gradle dependencies输出的树形结构，Sublime 不会高亮 scope 或提供折叠/搜索入口 - 调试能力为零：没有断点、变量监视、Step Into 支持；Groovy 脚本级调试必须切到 IntelliJ 或 VS Code + Java Extension Pack
真正卡住人的往往不是“怎么配”，而是发现高亮有了、build 能跑，但改一行 build.gradle 就触发不可见的 DSL 解析错误——这时候得看 Gradle 日志，而不是调 Sublime 设置。
