必须安装Jenkins Pipeline Linter Connector并配置正确linter URL，同时手动将Jenkinsfile关联为Groovy类型，否则stage、agent、sh等DSL关键字无法高亮或补全，因它们属于Jenkins运行时注入结构，非标准Groovy语法。
光装 Groovy 扩展没用，Jenkinsfile 里 stage、agent、sh 这些根本不会高亮或补全——它们不是 Groovy 语法，而是 Jenkins Pipeline DSL 注入的运行时结构。
必须手动把 Jenkinsfile 关联为 Groovy 类型
VSCode 默认不识别无扩展名的 Jenkinsfile，右下角显示 “Plain Text” 就代表整个高亮链已断。不改这个，后面所有插件都白装。
- 打开
settings.json（Cmd+, → 右上角点“打开设置(JSON)”） - 添加：
"files.associations": { "Jenkinsfile": "groovy" } - 保存后，**必须重新打开**该文件（已打开的不会自动刷新语言模式）
- 确认右下角显示的是 “Groovy”，不是 “Jenkinsfile” 或 “Plain Text”
要补全和校验，得装 Jenkins Pipeline Linter Connector
Groovy Language Support 扩展只认 def、if、for 这类标准语法，对 pipeline、stages、steps 完全无感。补全失效、拼错 stages 写成 stagez 都不报错，就是这个原因。
- 在扩展市场搜
Jenkins Pipeline Linter Connector（作者 jenkinsci，官方维护）并安装 - 它不提供本地语法分析，而是调 Jenkins 实例的
/pipeline-model-converter/validate端点做远程校验 - 填错 URL 不会报错，只会静默失效——你连红波浪线都看不到
jenkins.pipeline.linter.url 必须指向 validate 端点
这个配置值不是 Jenkins 主页，也不是 API 根路径，必须精确到 /pipeline-model-converter/validate，否则插件完全不工作。
- 先验证 Jenkins 是否支持：浏览器访问
http://your-jenkins-url/pipeline-model-converter/validate，返回{"status":"ok"}或 405 即可 - 在 VSCode 设置中搜索
jenkins.pipeline.linter.url，填完整 URL，结尾必须带/validate - 如果 Jenkins 启用了 CSRF（绝大多数生产环境都开），还要设
jenkins.pipeline.linter.csrf.enabled为true，并确保你当前登录态有效 - 别用
http://localhost:8080这种裸地址——它大概率 404，且插件不提示
校验失败？先看右下角状态栏有没有提示
装完插件、配好 URL、关联好类型后，右键点击编辑器任意位置，选 Validate Jenkinsfile。结果不出现在弹窗，而是在底部状态栏实时显示：
- 显示
Valid Jenkinsfile：说明链路通了，DSL 关键字开始被识别 - 显示错误行号和描述（如
Unknown stage name 'build'）：说明校验生效，但 Jenkinsfile 本身有逻辑问题 - 状态栏没反应、也没红波浪：99% 是
files.associations没生效，或jenkins.pipeline.linter.url填错了端点
最常被忽略的一点：所有配置修改后，VSCode 不会热重载语言服务。哪怕你改对了 settings.json，也得重新打开 Jenkinsfile 文件，甚至重启窗口（Cmd+Shift+P → Developer: Reload Window）才能让 Groovy Language Server 和 Linter Connector 同步加载新规则。
