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里是否被意外覆盖
Gradle 脚本必须用 gradlew 执行，不可直接用 groovy 命令
Gradle 构建逻辑和类路径由 gradlew 管理，直接用 groovy build.gradle 会报错（缺少插件类、DSL 方法未注册等）。
- 需另建
gradle.sublime-build，内容类似："cmd": ["./gradlew", "$1"]，"selector": "source.groovy, source.gradle" - Windows 用户把
./gradlew换成gradlew.bat，否则报 “The system cannot find the file specified” -
$1是占位符，运行时按 Ctrl+B 后输入build或test即可动态传参 - Gradle DSL 特性在 Sublime 中无法补全/跳转——它不解析上下文，不会提示
implementation的可用方法，也不能 Ctrl+Click 跳转到插件源码
最容易被忽略的是：Sublime 从不“理解” Groovy 语义，它只做高亮和命令转发；所有执行逻辑、类路径、DSL 支持，都严格依赖你本地终端环境是否真实就绪——尤其是 groovy 和 gradlew 是否能跨目录执行、是否带对的 Java 版本、是否加载了正确的依赖。
