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 不会报错，只是静默失效（没波浪线）

必须配对的三个硬性条件

缺一不可，否则校验完全不触发：

Pandas 配置文件报告生成器

使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。

下载

• 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 仍可能因凭据缺失、节点标签错、共享库加载失败等运行时问题中断——它只管语法结构，不管上下文环境。