VSCode本身不支持直接运行Groovy，必须先确保终端中groovy -v能正常输出版本、which groovy有路径输出、JAVA_HOME已正确指向JDK 11+根目录，再配置Code Runner或tasks.json调用系统groovy命令。
VSCode 本身不运行 Groovy，它只是调用你系统里已安装的 groovy 命令——所以第一步不是打开 VSCode，而是确认终端里能直接敲 groovy -v 并看到版本输出。
为什么点 ▶ 就报 “command not found”？
这是最常见、也最容易被忽略的前置失败点。VSCode 的所有运行方式（Code Runner、tasks.json、集成终端）都依赖系统 PATH 中存在可用的 groovy 可执行文件。
- 先在终端执行
which groovy（macOS/Linux）或where groovy（Windows），必须有输出，比如/opt/homebrew/bin/groovy或D:\groovy-4.0.6\bin\groovy.bat - 若无输出：说明 Groovy 没装，或没加进 PATH。推荐用
sdk install groovy（SDKMAN!）或brew install groovy（Homebrew）重装，并确保java -version能正常返回 JDK 11+ 版本 - 若
groovy -v报错ERROR: Environment variable JAVA_HOME has not been set：说明JAVA_HOME没配，或指向了 JRE 目录而非 JDK 根目录（如应为/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home，不能是.../jre）
Code Runner 一键运行怎么配才不翻车？
适合写完就跑的临时脚本，但默认配置对中文路径、空格、编码很敏感。
- 安装扩展
Code Runner（作者 Jun Han） - 打开设置 → 搜索
code-runner.executorMap→ 点“在 settings.json 中编辑” - 在
executorMap对象里加这一行："groovy": "groovy \"$fileName\""（macOS/Linux）；Windows 用户可改用"groovy": "groovy \"$fileName\""，注意双引号转义 - ⚠️ 如果脚本含中文或路径带空格，
$fileName可能被截断。此时应改用："groovy": "groovy -Dfile.encoding=UTF-8 \"${file}\""，${file}是 VSCode 内置变量，自动包裹完整路径
tasks.json 运行更稳，但要注意这三点
比 Code Runner 更可控，尤其适合需要传参、指定工作目录或捕获错误的场景，比如 CI 验证脚本。
- 在项目根目录建
.vscode/tasks.json，内容至少包含label、type、command和args -
command必须填绝对路径（如/opt/homebrew/bin/groovy），不能只写groovy——否则任务可能在某些 workspace 下失效 -
args推荐用"${file}"而非"$fileName"，前者带完整路径，后者只含文件名，跨目录运行时容易找不到文件 - 额外建议加
"group": "build"和"presentation": { "echo": true, "reveal": "always", "panel": "shared" }，让输出更清晰、面板复用
调试 .groovy 文件得靠 Java Debugger，不是 Groovy 插件
Groovy 编译成字节码跑在 JVM 上，VSCode 没有原生 Groovy 调试器。你必须用 Debugger for Java，并手动告诉它“这其实是 Java 字节码”。
- 装
Extension Pack for Java（含 Debugger for Java） - 在项目根目录建
.vscode/launch.json，configurations里加一项："type": "java"，"request": "launch"，"mainClass": "groovy.ui.GroovyMain"，再通过"args"传入当前文件路径，例如"${file}" - 别指望断点能直接打在
def x = 1上就停住——Groovy 的 AST 转换会让行号偏移，实际断点位置往往在生成的内部类里；建议在方法调用处设断点，或用println辅助定位
最常被跳过的环节是验证 groovy 是否真能在终端跑通，以及误把 groovy.sdkPath（旧版弃用项）当 groovy.executablePath 去填。路径不对，高亮可以有，运行和补全一定挂。
