vscode无法运行groovy的根源在于系统级环境未就绪：终端中which groovy无输出、java_home未指向jdk 11+根目录或groovy -v报错，均会导致所有运行方式失败；必须先修复这些底层问题，再配置groovy.executablepath为可执行文件绝对路径，并确保files.associations正确关联.groovy文件。
VSCode 无法运行 Groovy，90% 是因为 groovy 命令在终端里根本跑不通——不是插件没装对，是底层命令链断了。
终端里 groovy -v 报错就别往下配了
VSCode 所有运行方式（Code Runner、tasks.json、集成终端）最终都调用系统 groovy 可执行文件。它不认你装没装插件，只看 PATH 里有没有这个命令、JAVA_HOME 指向是否合法。
- 打开 VSCode 集成终端，执行
which groovy（macOS/Linux）或where groovy（Windows），必须输出完整路径，比如/opt/homebrew/bin/groovy或D:\groovy-4.0.6\bin\groovy.bat - 执行
echo $JAVA_HOME（macOS/Linux）或echo %JAVA_HOME%（Windows），输出必须是 JDK 11+ 的根目录（如/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home），不能是jre子目录 - 执行
groovy -v，必须打印版本号；如果报Environment variable JAVA_HOME has not been set，说明 JDK 没装或JAVA_HOME配错
任一失败，先停手。重装 Groovy（推荐 sdk install groovy 或 brew install groovy）、重装 JDK（Temurin 17+）、再设对 JAVA_HOME 和 PATH。VSCode 不会帮你修这些。
groovy.executablePath 必须填可执行文件路径，不是 SDK 根目录
很多用户把 groovy.sdkPath（旧版弃用项）和 groovy.executablePath 混了。前者指向 SDK 根目录（如 /opt/homebrew/opt/groovy/libexec），后者必须是 groovy 这个二进制文件的**绝对路径**。
- 在 VSCode 设置中搜索
groovy.executablePath，粘贴which groovy的输出结果（注意 Windows 上要填.bat文件全路径） - 填完立刻生效，但建议关掉再重开一个
.groovy文件，看右下角状态栏是否显示Groovy—— 如果还是Plain Text，说明files.associations没配 - 检查
settings.json是否有："files.associations": { "*.groovy": "groovy", "Jenkinsfile": "groovy", "*.gradle": "groovy" }
Code Runner 运行失败？大概率是引号或编码没转义
默认配置 "groovy": "groovy \"$fileName\"" 在路径含空格或脚本含中文时会崩，且不处理终端编码问题。
- 如果脚本路径带空格（如
/Users/me/My Project/script.groovy），$fileName展开后未加引号会导致命令截断 - 如果脚本含中文，Linux/macOS 终端默认 UTF-8，但 Windows CMD 默认 GBK，
groovy读取时乱码，直接报错或输出问号 - 安全写法是：
"groovy": "groovy -Dfile.encoding=UTF-8 \"$fileName\""（macOS/Linux）或"groovy": "groovy -Dfile.encoding=UTF-8 \"$fileName\""（Windows，CMD 下可用，PowerShell 推荐用cmd /c包一层）
Jenkinsfile 里 stage 不提示？这不是 Groovy 的事
stage、agent、sh 等不是 Groovy 关键字，是 Jenkins Pipeline DSL 动态注入的闭包方法。Groovy Language Support 扩展根本不认识它们。
- 必须额外安装
Jenkins Pipeline Linter Connector插件 - 设置
jenkins.pipeline.linter.url为完整 URL，结尾必须是/pipeline-model-converter/validate（例如http://your-jenkins.example.com/pipeline-model-converter/validate） - 该 URL 必须能返回
{"status":"ok"}或 HTTP 405（说明端点存在），不能是首页或 404 - 同时确认 Jenkins 已安装
Pipeline Utility Steps插件，否则校验服务起不来
真正容易被忽略的是：VSCode 不会告诉你 linter URL 配错了——它只是静默跳过校验，连红波浪线都不会画。验证方式只有一个：手动 curl 那个 URL 看返回。
