VSCode无法直接运行Jenkinsfile，因其依赖Jenkins运行时注入的DSL（如sh、stage）和全局变量；本地仅能通过groovy命令执行纯Groovy脚本，或调用Jenkins实例的/pipeline-model-converter/validate端点做语法校验。
VSCode 本身不执行 Jenkinsfile，它只是编辑器；所谓“本地运行”，实际是调用系统 groovy 命令解析脚本逻辑，或通过 Jenkins 实例的 /pipeline-model-converter/validate 端点做语法校验——两者目的不同、能力不同、失败原因也完全不同。
为什么 groovy Jenkinsfile 总报错：MissingMethodException 或 NoClassDefFoundError
因为 Jenkinsfile 不是纯 Groovy 脚本，它依赖 Jenkins 运行时注入的全局变量（env、params、sh、stage 等）和 Pipeline DSL 类。直接用 groovy Jenkinsfile 执行，等于让 Groovy 解释器硬跑一段缺失上下文的代码。
- 常见错误现象：
No signature of method: Script1.sh() is applicable、java.lang.NoClassDefFoundError: org/jenkinsci/plugins/workflow/cps/GlobalVariable - 这不是你写错了，是执行环境不对——
groovy命令根本不知道sh是什么 - 真正能“运行”Jenkinsfile 的只有 Jenkins 控制器（Controller）或
jenkinsci/jenkins:lts容器 - 本地唯一可行的模拟方式是：用
docker run --rm -v $(pwd):/workspace -w /workspace jenkinsci/jenkins:lts groovy -cp /usr/share/jenkins/jenkins.war groovy.lang.GroovyShell加载 Jenkins 类路径（极不推荐，启动慢、依赖 WAR 包路径）
Jenkins Pipeline Linter Connector 校验失败的 3 个关键条件
这个插件不是在本地运行 Jenkinsfile，而是把内容 POST 到 Jenkins 的 /pipeline-model-converter/validate 接口。校验失败，90% 情况下不是脚本问题，而是连接链路断了。
- 必须确保 Jenkins 实例已启用
Pipeline Utility Steps插件（否则/pipeline-model-converter/validate404） -
jenkins.pipeline.linter.url设置值必须是完整 URL，且末尾不带斜杠，例如：http://localhost:8080/pipeline-model-converter/validate（多一个/就 405） - 如果 Jenkins 开启了 CSRF 保护或登录认证，插件默认不带凭证——需在设置中补全
jenkins.pipeline.linter.username和jenkins.pipeline.linter.password，或改用 API Token
用 Code Runner 运行 .groovy 工具脚本，但别碰 Jenkinsfile
你可以放心用 Code Runner 快速执行自己写的辅助 Groovy 脚本（比如解析日志、生成参数），但它对 Jenkinsfile 没有意义——因为 Jenkinsfile 的语义只在 Jenkins 运行时存在。
- 确认
groovy -v在 VSCode 集成终端里能输出版本，否则Code Runner会静默失败 - 在
settings.json中配置："groovy": "groovy -Dfile.encoding=UTF-8 \"$fileName\""（加-Dfile.encoding=UTF-8防中文乱码） - 右下角文件类型必须显示为
Groovy，不是Jenkinsfile——检查files.associations是否误配了"Jenkinsfile": "groovy"，这会导致语法高亮正确但校验失效 - 若脚本需访问 Jenkins 全局变量，别硬写；改用
curl -X POST调 Jenkins REST API 模拟更靠谱
最常被忽略的一点：Jenkinsfile 的“可运行性”永远绑定在具体 Jenkins 实例的插件集和版本上。你在本地验证通过的 Jenkinsfile，换到另一台 Jenkins 上仍可能因缺少某个插件（比如 git、docker-workflow）而失败——校验只是语法层，不是运行时依赖层。
