VSCode中Groovy支持需安装扩展、配置SDK路径、启用groovysh、设置任务运行器及Code Runner插件。依次完成语法高亮、执行、调试与快速运行功能。
如果您在 VSCode 中使用 Apache Groovy 进行自动化任务或脚本编写，但发现语法高亮异常、代码补全失效或运行失败，则可能是由于扩展配置缺失或 Groovy 运行时未正确集成。以下是解决此问题的步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装 Groovy 扩展与语言支持
VSCode 默认不内置 Groovy 支持，需通过第三方扩展提供语法识别、括号匹配及基础语义高亮功能。该步骤确保编辑器能正确解析 .groovy 文件结构。
1、打开 VSCode，点击左侧活动栏的扩展图标（或按快捷键 Ctrl+Shift+X）。
2、在搜索框中输入 Groovy Language Support，选择由 pkozhevnikov 发布的扩展并点击“安装”。
3、安装完成后，重启 VSCode 使扩展生效。
二、配置本地 Groovy SDK 路径
VSCode 需明确知晓 Groovy 可执行文件位置，才能调用 groovy 命令执行脚本或启用调试功能。该路径必须指向已安装的 Groovy 二进制目录。
1、在终端中运行 which groovy，确认 Groovy 已全局可用；若无输出，请先通过 SDKMAN! 或 Homebrew 安装 Groovy。
2、在 VSCode 中按下 Cmd+, 打开设置，搜索 groovy.executablePath。
3、在设置项中输入完整路径，例如 /opt/homebrew/bin/groovy（Homebrew 安装路径）或 ~/.sdkman/candidates/groovy/current/bin/groovy（SDKMAN! 安装路径）。
三、启用 Groovy Shell（groovysh）交互式运行
通过集成终端直接调用 groovysh，可实现脚本片段快速验证与动态对象探索，无需保存为文件即可执行表达式。
1、在 VSCode 中打开集成终端（Terminal → New Terminal）。
2、输入命令 groovysh 启动交互式环境。
3、在提示符后输入任意 Groovy 表达式，例如 println "Hello, Groovy!"，按回车立即查看结果。
四、配置任务运行器以执行 .groovy 脚本
VSCode 任务系统允许将 groovy 命令封装为可一键触发的构建任务，适用于批量运行自动化脚本或 CI 前置检查。
1、在项目根目录下创建 .vscode/tasks.json 文件（若不存在）。
2、填入以下内容，确保 label 字段为 Run Groovy Script，且 command 指向 groovy 可执行文件。
3、保存后，按 Cmd+Shift+P，输入 Tasks: Run Task，选择该任务，再指定当前打开的 .groovy 文件即可执行。
五、使用 Code Runner 插件快速执行单文件脚本
Code Runner 提供轻量级一键执行能力，特别适合临时脚本调试，无需配置 tasks.json 即可运行当前编辑器中的 Groovy 代码。
1、安装扩展 Code Runner（作者 Jun Han）。
2、打开 VSCode 设置，搜索 code-runner.executorMap，点击“在 settings.json 中编辑”。
3、在 executorMap 对象内添加键值对："groovy": "groovy"，确保其位于 JSON 对象合法位置并保留逗号分隔。
