VSCode运行Groovy的前提是系统已正确安装Groovy和JDK 11+，且JAVA_HOME指向有效JDK根目录；需配置groovy.executablePath为完整可执行路径，并确保VSCode能继承终端PATH环境。
VSCode 本身不运行 Groovy，它只是调用你系统里装好的 groovy 命令——所以“能运行”的前提是终端里 groovy -v 有输出、JAVA_HOME 指向有效的 JDK 11+，否则所有配置都白搭。
确认 groovy 和 JAVA_HOME 已就绪
这是硬门槛，跳过直接失败。打开 VSCode 集成终端（Terminal → New Terminal），执行：
-
which groovy（macOS/Linux）或where groovy（Windows），必须返回完整路径，比如/opt/homebrew/bin/groovy或D:\apache-groovy-sdk-4.0.6\groovy-4.0.6\bin\groovy.bat -
echo $JAVA_HOME（macOS/Linux）或echo %JAVA_HOME%（Windows），必须输出 JDK 根目录（不是jre子目录），例如/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home -
groovy -v必须打印版本号，不能报Environment variable JAVA_HOME has not been set
任一失败，先回终端解决：用 sdk install groovy（SDKMAN!）或 brew install groovy（Homebrew）装 Groovy；用 Oracle 或 Temurin 装 JDK 17+，再设对 JAVA_HOME 和 PATH。
配置 groovy.executablePath 是关键一步
VSCode 的 Groovy 扩展（推荐用 pivotal.groovy）需要明确知道 groovy 命令在哪，否则高亮能有，但补全、跳转、DSL 校验全挂。
- 在 VSCode 设置中搜
groovy.executablePath，填入which groovy的**完整可执行文件路径**（不是 SDK 根目录！） - 填完立刻生效，但建议重开一个
.groovy文件，看右下角是否显示Groovy（不是Plain Text或Jenkinsfile） - 如果右下角还是错的，检查
settings.json里有没有漏掉"files.associations": { "*.groovy": "groovy" }
用 Code Runner 一键运行最省事
适合写小脚本、快速验证逻辑，不用写 tasks.json，但要注意引号和编码问题。
- 装扩展
Code Runner（作者 Jun Han） - 在
settings.json中修改code-runner.executorMap，加这一行："groovy": "groovy \"$fileName\"" - 如果脚本含中文或路径有空格，改成：
"groovy": "groovy -Dfile.encoding=UTF-8 \"$fileName\"" - 点击右上角 ▶️ 或按
Ctrl+Alt+N（Win/Linux）/Cmd+Option+N（macOS）运行
tasks.json 运行更可控，但容易漏掉 args 引号
比 Code Runner 多支持参数、工作目录、错误定位，适合 CI 前置检查或带 classpath 的脚本，但写错 args 就静默失败。
- 项目根目录建
.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 } }] } - 重点是
"args": ["${file}"]—— 必须用数组形式，且${file}自动带引号，避免路径空格导致命令截断 - 运行方式：
Cmd+Shift+P→ 输入Tasks: Run Task→ 选groovy-run
真正容易被忽略的是：Groovy 扩展不负责运行，groovy.executablePath 配错或没配，Code Runner 和 tasks.json 都会 fallback 到 PATH 查找——而一旦你的终端 PATH 和 VSCode 启动方式不一致（比如从桌面图标启动 macOS VSCode），PATH 可能根本没继承你 shell 里的配置，这时候 which groovy 在终端有，但在 VSCode 里却找不到。
