sublime text 配置 groovy 环境需三步：先确保系统已安装 groovy 并加入 path，再创建 groovy.sublime-build 构建系统，最后将 .groovy 文件语法设为 groovy（推荐 gr8 插件）。
Sublime Text 本身不带 Groovy 运行时，所谓“配置 Groovy 环境”，就是让它能调用你系统里已装好的 groovy 命令——这一步没走通，后面全白搭。
确认系统级 groovy 命令可用
这是最常被跳过的前置步骤。Sublime 不会帮你装 Groovy，它只负责调用。
- 在终端（macOS/Linux）或命令提示符（Windows）中执行
groovy -v，必须输出类似Groovy 4.0.15的版本信息 - 如果报错
command not found或'groovy' is not recognized，说明 Groovy 没装，或没加进PATH - Windows 用户注意：别只双击安装 Groovy，要手动把
GROOVY_HOME/bin加入系统环境变量PATH，然后重启 Sublime（否则它读不到新 PATH）
创建 groovy.sublime-build 构建系统
Sublime 需要明确知道怎么运行 .groovy 文件，groovy.sublime-build 就是这个指令说明书。
- 菜单栏 → Tools → Build System → New Build System…
- 清空默认内容，粘贴以下内容（注意平台差异）：
{
"cmd": ["groovy", "$file"],
"file_regex": "^(...*?):([0-9]+):?([0-9]+)?:? (.*)$",
"selector": "source.groovy",
"encoding": "utf-8"
}
- 保存为
groovy.sublime-build，路径自动落在Packages/User/下 - Windows 用户若用 PowerShell 或 cmd 启动失败，可改用
"shell_cmd": "groovy \"$file\""（但会丢失$file中的空格处理能力） -
file_regex用于点击错误跳转到对应行；若你常用groovysh或groovyc，需单独建 build 文件，不能混用
让 .groovy 文件正确识别为 Groovy 语法
即使构建系统存在，文件若被识别为 Plain Text，就无法触发高亮、缩进、括号匹配等基础能力。
- 打开任意
.groovy文件，右下角点击当前语言名（如 “Plain Text”） - 选择
Groovy（不是 “Groovy (TextMate)” 或其他变体；若没有该选项，说明没装 Groovy 语法包） - 接着点 View → Syntax → Open all with current extension as… → 再选
Groovy，这样所有.groovy文件下次都会自动识别 - 常见干扰：同时装了
Groovy和Gr8插件，会导致语法定义冲突，高亮忽明忽暗；建议只留Gr8（它更现代，支持 Gradle DSL 关键字）
build.gradle 文件仍是纯文本？不是 Groovy 配置问题
这是高频误判点：build.gradle 显示 “Plain Text”，和 Groovy 构建系统完全无关——它根本没被当成 Groovy 文件解析。
- 右下角点语言名 → 看有没有
Gr8/Groovy选项；没有就说明Gr8插件没装或失效 - 用 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 插件 + 手动绑定语法
最容易被忽略的是：Groovy 脚本里用了中文路径、空格或特殊字符（如 My Project/script.groovy），某些旧版 groovy.sublime-build 会因 shell 解析失败而静默退出——建议先用无空格路径验证是否真能跑起来。
