jenkinsfile 校验由 jenkins 服务端完成，vscode 仅通过插件将内容 post 至 /pipeline-model-converter/validate 接口；需配置正确 url、groovy 语言模式及 linter 插件，且依赖 csrf token、ssl 设置与文件名规范。
校验不是本地运行，而是发请求到 Jenkins API
VSCode 本身不解析 sh、agent 或 stage 这些 Jenkins DSL 关键字——它只负责把当前 Jenkinsfile 内容 POST 到 Jenkins 的 /pipeline-model-converter/validate 接口。校验结果来自 Jenkins 服务端的 Pipeline Model Interpreter，不是 VSCode 自己判断的。
这意味着：
- 你写的
node('linux') { sh 'ls' }在 VSCode 里不会高亮sh，也不会补全参数，这是正常现象 - 语法正确 ≠ 能跑通：比如
withCredentials引用了一个不存在的凭据 ID，校验会通过，但 Jenkins 执行时会失败 - 所有校验依赖 Jenkins 实例在线且该 API 可访问；断网或 Jenkins 重启后，VSCode 不会报错，只是静默失效（没波浪线）
必须配对的三个硬性条件
缺一不可，否则校验完全不触发：
-
jenkins.pipeline.linter.connector.url必须精确到/pipeline-model-converter/validate，例如http://192.168.1.100:8080/pipeline-model-converter/validate；写成http://localhost:8080或http://jenkins.example.com/jenkins都返回 404，插件不提示 -
Jenkinsfile文件右下角语言模式必须是Groovy，不是Plain Text或Jenkinsfile；可在右下角点击 → “Configure File Association for 'Jenkinsfile'” → 选groovy，或在.vscode/settings.json中加"files.associations": { "Jenkinsfile": "groovy" } - 必须安装
Jenkins Pipeline Linter Connector插件；Jenkins Pipeline Support和Groovy Language Support只负责高亮和基础语法，不触发校验
CSRF 和凭证配置最容易出错
Jenkins 默认开启 CSRF 保护，不配 crumb 就会卡在 403。
- 如果
jenkins.pipeline.linter.connector.crumbUrl没填，或填错（比如漏了/api/json），请求会被拒绝，OUTPUT 面板显示403 No valid crumb - 推荐用 API Token 替代密码：
jenkins.pipeline.linter.connector.token填 Jenkins 用户页生成的 token，pass字段留空 - 内网或自签名证书环境必须设
jenkins.pipeline.linter.connector.strictssl为false，否则 HTTPS 请求直接失败 - 环境变量方式更安全：
"jenkins.pipeline.linter.connector.token": "${env:JENKINS_TOKEN}"，避免明文写在 settings 里
中文、换行、未保存文件的隐性问题
旧版插件（如原始 vscode-jenkins-pipeline-linter-connector）对非 ASCII 字符支持差：
- 含中文的
Jenkinsfile可能返回乱码错误，例如echo '构建完成'校验时报unexpected char:0xB8 - 部分版本只在校验已保存的文件，未保存修改时点“Validate Jenkinsfile”无响应；建议用 fork 后修复过的版本（如社区维护分支）
- 若 Jenkinsfile 名不是标准
Jenkinsfile（如叫ci.groovy或workflow.jenkins），需手动配置白名单或重命名，否则插件忽略该文件
Jenkinsfile 仍可能因凭据缺失、节点标签错、共享库加载失败等运行时问题中断——它只管语法结构，不管上下文环境。
