Sublime Text 不能直接运行 Groovy 脚本，仅能调用系统已安装的 groovy 命令；需先确保终端可执行 groovy --version，再配置 groovy.sublime-build 构建系统并安装 Gr8 插件实现语法高亮与执行。
Sublime Text 不能直接运行 Groovy 脚本，它只调用你系统里装好的 groovy 命令——这一步不通，后面全卡死。
确认 groovy 命令在终端能跑通
这是 90% 配置失败的根源。Sublime 的构建系统默认继承系统 PATH，如果终端里执行 groovy --version 报 “command not found”，Sublime 肯定也找不到。
- macOS/Linux：推荐用
sdk install groovy（SDKMAN!），自动配好 PATH 和GROOVY_HOME - Windows：用
scoop install groovy，比手动解压+配环境变量更稳 - 别只装 JDK 就以为够了——Groovy 是独立运行时，
java -version成功 ≠groovy --version成功 - 装完必须彻底退出 Sublime Text（不是关标签页），再重新打开，否则旧 PATH 不刷新
- Windows 用户注意：
groovy.bat和groovy（无后缀）行为不同；Build System 应调用后者（SDKMAN/Scoop 安装默认提供）
创建并配置 groovy.sublime-build
路径是 Sublime Text → Tools → Build System → New Build System，粘贴以下内容后保存为 groovy.sublime-build：
{
"cmd": ["groovy", "$file"],
"file_regex": "^(*?):([0-9]*):?([0-9]*):? (.*)$",
"working_dir": "${file_path}",
"selector": "source.groovy",
"shell": false
}
- macOS/Linux 和 Windows（用 SDKMAN/Scoop 安装）都用
"cmd": ["groovy", "$file"]，不用cmd /c或groovy.bat -
"shell": false更安全，避免 shell 解析干扰路径（尤其含空格或中文时） -
"selector": "source.groovy"让 Ctrl+B 自动触发该构建系统，前提是文件已设对语法高亮 - 如果脚本依赖外部 JAR，得显式加
-cp，比如"cmd": ["groovy", "-cp", "/path/to/lib.jar", "$file"]
让 .groovy 文件正确高亮
默认打开 .groovy 文件是纯文本，没颜色、没关键字识别——这不是构建问题，是语法定义没加载。
- 用 Package Control 安装
Gr8插件（不是老版 Groovy 插件），它支持 Gradle DSL 关键字（如implementation） - 安装后右下角点击 “Plain Text” → “Open all with current extension as” → 选
Gr8/Groovy - 如果
build.gradle还显示成 XML 风格，检查Preferences → Settings – Syntax Specific里是否残留"syntax": "Packages/XML/XML.tmLanguage"，删掉
Gradle 脚本必须用 gradlew 执行，不可直接用 groovy 命令
Gradle 构建脚本（build.gradle）本质是 Groovy DSL，但它的执行上下文由 Gradle 提供，groovy 命令无法解析 plugins、dependencies 等 DSL 结构，会直接报错。
- 要运行任务，应新建一个
gradle.sublime-build，"cmd"设为["./gradlew", "$1"]（Linux/macOS）或["gradlew.bat", "$1"]（Windows） -
$1是占位符，按 Ctrl+B 后输入build或test即可传参 - 别指望 Sublime 补全
implementation或跳转插件源码——它不解析 DSL 语义，只做语法着色
最常被忽略的是：Groovy 语法高亮和构建执行是两件事，各自依赖不同条件；而 Gradle 脚本一旦被误当成普通 Groovy 脚本执行，错误信息往往指向语法本身，其实只是执行环境错了。
