VSCode本身不支持直接运行Groovy，必须配置groovy可执行路径或通过tasks.json/Code Runner调用系统groovy命令；前提是终端中which groovy有输出、JAVA_HOME已设且groovy -v能正常显示版本，否则所有运行方式均会失败。
VSCode 本身不支持直接运行 Groovy，必须显式配置可执行路径或借助任务系统调用 groovy 命令；否则点击“运行”会报错或静默失败。
确认 groovy 命令已在终端可用
这是所有后续配置的前提。VSCode 的任务、Code Runner、调试器都依赖系统 PATH 中的 groovy 可执行文件。
- 打开终端，执行
which groovy（macOS/Linux）或where groovy（Windows），确认有输出（如/opt/homebrew/bin/groovy） - 若无输出，需先安装 Groovy：推荐用
sdk install groovy（SDKMAN!）或brew install groovy（Homebrew） - 同时确保
JAVA_HOME已正确设置且指向 JDK 11+，因为groovy是 JVM 应用，启动时会检查该变量 - 执行
groovy -v验证版本输出，避免出现ERROR: Environment variable JAVA_HOME has not been set
用 Code Runner 快速一键运行（适合脚本片段）
Code Runner 是最轻量的运行方式，适合写完就跑的临时脚本，但不支持调试、参数传入或复杂 classpath 控制。
- 安装扩展
Code Runner（作者：Jun Han） - 在 VSCode 设置中搜索
code-runner.executorMap，点击“在 settings.json 中编辑” - 添加或修改 Groovy 条目：
"groovy": "groovy \"$fileName\""
（注意双引号转义，Windows 可用groovy "$fileName"） - 保存后，打开
.groovy文件，点击右上角 ▶️ 图标，或按Ctrl+Alt+N（Win/Linux） /Cmd+Option+N（macOS） - ⚠️ 坑：如果脚本含中文或路径含空格，
Code Runner默认命令可能失败；此时应改用tasks.json方式并加引号包裹"${file}"
用 tasks.json 运行（推荐用于工程化脚本）
比 Code Runner 更可控，支持参数、工作目录、错误解析，且与 VSCode 任务系统深度集成，适合 CI 前置检查、工具类脚本等场景。
- 在项目根目录创建
.vscode/tasks.json（若不存在） - 填入标准结构，关键字段如下：
{ "version": "2.0.0", "tasks": [ { "label": "groovy-run", "type": "shell", "command": "groovy", "args": ["${file}"], "group": "build", "presentation": { "echo": true, "reveal": "always", "focus": false, "panel": "shared", "showReuseMessage": true, "clear": true }, "problemMatcher": [] } ] } - 保存后，按
Cmd+Shift+P→ 输入Tasks: Run Task→ 选择groovy-run - ✅ 优势：支持
args动态传参（如"--config", "dev.conf"），可绑定快捷键，错误输出能被problemMatcher捕获（需额外配置 Groovy-specific matcher）
为什么装了 Groovy 扩展却不能运行？
很多人卡在这一步：装了 pivotal.groovy 或其他 Groovy 语法扩展，但右键“Run Code”仍报错或无反应——因为这些扩展只提供语法高亮和 LSP 支持，不包含执行能力。
- 语法扩展（如
pivotal.groovy）负责highlight、go to definition、hover，但不提供run或debug -
groovy.executablePath设置项（部分扩展提供）仅用于其内部诊断，不影响 Code Runner 或 tasks - 真正决定“能不能跑”的，是你的系统 PATH +
tasks.json或code-runner.executorMap配置是否指向有效的groovy二进制 - 如果你用的是 SDKMAN! 安装的 Groovy，路径通常是
~/.sdkman/candidates/groovy/current/bin/groovy；Homebrew 则多为/opt/homebrew/bin/groovy（Apple Silicon）或/usr/local/bin/groovy（Intel）
最容易被忽略的一点：Groovy 脚本里用了 Jenkins Pipeline DSL（比如 pipeline、stage）或 Gradle API（比如 dependencies），这些不是纯 Groovy 语法，groovy 命令直接执行会报 MissingMethodException —— 此时你不是环境配错了，而是不该用 groovy xxx.groovy 运行，而该用 jenkins-linter 校验或 gradle 执行。
