Sublime Text 需手动配置 Groovy Build System，前提是系统已正确安装 Groovy SDK 并配置 GROOVY_HOME 和 PATH；终端能运行 groovy --version 是必要前提，否则 Sublime 无法调用；创建 Groovy.sublime-build 文件并设 "shell": false；绑定 .groovy 文件语法高亮；常见错误包括类定义误用、中文路径编码及外部 JAR 未指定 -cp。
Sublime Text 本身不内置 Groovy 运行支持，必须通过 Build System 手动配置；关键不是“装插件”，而是确保系统已安装 Groovy SDK 且 GROOVY_HOME 和 PATH 正确，否则任何构建配置都会报 command not found: groovy 或 Unable to find Groovy。
确认 groovy 命令在终端可用
这是最常被跳过的前置步骤。Sublime 的 Build System 默认继承系统 PATH，如果终端里都跑不了 groovy --version，Sublime 肯定也找不到。
- 打开终端（macOS/Linux）或命令提示符/PowerShell（Windows），执行：
groovy --version
- 若提示命令未找到，先安装 Groovy：推荐用 SDKMAN（macOS/Linux）或 Scoop（Windows），避免手动配环境变量出错
- 安装后重新打开 Sublime Text（注意：不是重启标签页，是彻底退出再启动，否则 PATH 不刷新）
- Windows 用户特别注意：
groovy.bat和groovy（无后缀）行为不同，Build System 应调用groovy（SDKMAN/Scoop 安装的默认可执行名），而非groovy.bat
创建 Groovy.sublime-build 文件
Build System 本质是 JSON 配置文件，告诉 Sublime 用什么命令、带什么参数运行当前文件。Groovy 脚本通常只需直接执行，不需要编译阶段。
- 菜单栏选择 Tools → Build System → New Build System…
- 替换全部内容为以下配置（适配跨平台，自动传入当前文件路径）：
{ "cmd": ["groovy", "$file"], "file_regex": "^(...*?):([0-9]*):?([0-9]*):? (.*)$", "selector": "source.groovy", "shell": false, "windows": { "cmd": ["groovy", "$file"] } } - 保存为
Groovy.sublime-build（文件名必须以.sublime-build结尾，保存路径默认是用户 Packages 目录） -
"shell": false是关键：设为true在 Windows 下可能触发 cmd.exe 解析错误，导致路径空格处理失败
设置语法高亮与文件关联
没有语法高亮，写 Groovy 就像裸眼调试。Sublime 默认不识别 .groovy 后缀，需手动绑定。
- 打开一个
.groovy文件 → 菜单栏 View → Syntax → Open all with current extension as… → Groovy - 如果列表里没有
Groovy，说明没装 Groovy 语法包：用 Package Control 安装Gr8Grovvy或Groovy（后者更轻量，仅语法） - 安装后重启 Sublime，再执行上一步绑定，以后所有
.groovy文件都会自动高亮 - 验证是否生效：关键词如
def、println应变色，括号能匹配高亮
运行时常见错误及修复
即使配置完成，实际运行仍可能卡在几个具体点上，错误信息往往藏在 Sublime 底部状态栏或小黑窗里。
-
Error: Could not find or load main class：脚本用了class定义但没加static void main，Groovy 脚本应直接写逻辑，不要包 class（除非你明确要编译成类） -
java.lang.NoClassDefFoundError：脚本引用了外部 JAR，但groovy命令没加-cp。此时需改写Build System的cmd，例如："cmd": ["groovy", "-cp", "/path/to/lib/*", "$file"]
- 中文路径报错（Windows 最常见）：Sublime 传递的
$file是 UTF-8 编码，但 Windows 默认 CMD 是 GBK。解决方案是改用 PowerShell 启动："cmd": ["powershell", "-Command", "groovy '$file'"], "shell": true
- 想调试或传参？Build System 不支持交互式输入。临时方案：在脚本开头加
println 'args: ' + args，然后修改cmd为"cmd": ["groovy", "$file", "arg1", "arg2"]
真正卡住的往往不是 Sublime 配置，而是 Groovy 环境本身是否就绪——特别是多版本共存时 groovy 命令指向哪个 SDK。建议用 which groovy（macOS/Linux）或 where groovy（Windows）确认实际路径，再比对 $GROOVY_HOME 是否一致。
