VSCode配置Groovy需三步：装Groovy Language Support扩展、在settings.json中配置files.associations关联Jenkinsfile/.gradle/.groovy文件类型、设置groovy.executablePath为完整可执行路径；缺一不可，否则高亮、运行、补全、DSL校验均失效。
直接装 Groovy Language Support 扩展 + 手动关联文件类型 + 配置本地 groovy 可执行路径，三步到位。光装扩展不配路径，高亮能有，但运行、补全、跳转全失效。
为什么装了 Groovy 扩展还是没高亮？
VSCode 默认不把 Jenkinsfile 或 build.gradle 当作 Groovy 处理，右下角显示 “Plain Text” 就是典型信号。
- 打开
settings.json（Cmd+, → 右上角“打开设置(JSON)”） - 添加：
"files.associations": { "Jenkinsfile": "groovy", "*.gradle": "groovy", "*.groovy": "groovy" } - 保存后重新打开文件，右下角必须显示
Groovy，不是Jenkinsfile或其他名称
groovy.executablePath 必须设对，否则 Code Runner 和终端执行都报错
Code Runner 插件或集成终端里敲 groovy xxx.groovy 报 “command not found”，基本都是这个路径没配准。
- 先在终端跑
which groovy或groovy -version确认安装位置 - 常见路径：
/opt/homebrew/bin/groovy（macOS Homebrew）、~/.sdkman/candidates/groovy/current/bin/groovy（SDKMAN!）、D:\apache-groovy-sdk-4.0.6\groovy-4.0.6\bin\groovy.bat（Windows） - 在 VSCode 设置中搜
groovy.executablePath，填**完整可执行文件路径**，不是 SDK 根目录
Jenkinsfile 里 stage/steps 不提示？这不是语法问题，是 DSL 缺少校验链
Groovy Language Support 本身不认识 stage、agent、sh —— 它们是 Jenkins 运行时注入的 DSL 方法，不是 Groovy 关键字。
- 必须额外装
Jenkins Pipeline Linter Connector - 配置
jenkins.pipeline.linter.url为http://your-jenkins/pipeline-model-converter/validate（结尾必须带/validate） - 确保 Jenkins 已装
Pipeline Utility Steps插件，且该 URL 能返回{"status":"ok"}或 405 - CSRF 开启时，还要设
jenkins.pipeline.linter.csrf.enabled为true并保持登录态
最常被跳过的环节是文件关联和 linter URL 的结尾路径 —— 少一个斜杠、多一个空格，整个校验就静默失效，连红波浪线都不会出现。
