需安装 Groovy 扩展、配置文件关联、集成 Groovy Language Server、启用 Jenkins Pipeline 校验、配置 Gradle 项目感知，才能在 VSCode 中为 Jenkinsfile 和 build.gradle 提供完整开发支持。
如果您在 Visual Studio Code 中编写 Jenkinsfile 或 Gradle 脚本（如 build.gradle），但缺乏语法高亮、代码补全或错误提示支持，则可能是由于 Groovy 语言支持未正确配置。以下是为 VSCode 添加 Groovy 开发能力的具体操作步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装 Groovy 扩展
VSCode 本身不内置 Groovy 支持，需通过官方扩展市场安装语言支持插件，以启用语法识别、括号匹配与基础语义检查。
1、打开 VSCode，点击左侧活动栏的扩展图标（四个方块组成的图标）。
2、在扩展搜索框中输入 Groovy Language Support。
3、在搜索结果中找到作者为 pivotal 的扩展（图标为绿色 G 字母），点击“安装”按钮。
4、安装完成后，重启 VSCode 使扩展完全生效。
二、配置文件关联规则
VSCode 默认不会将 Jenkinsfile 或 .gradle 文件自动识别为 Groovy 类型，需手动设置文件关联，确保语法高亮与智能提示正常触发。
1、打开 VSCode 设置（快捷键 Cmd + ,）。
2、在设置搜索框中输入 files.associations。
3、点击“在 settings.json 中编辑”，在 JSON 对象内添加以下键值对：
“Jenkinsfile”: “groovy”,
“*.gradle”: “groovy”
4、保存 settings.json 文件，重新打开任意 Jenkinsfile 或 build.gradle 文件验证高亮效果。
三、集成 Groovy Language Server
仅靠语法高亮无法提供代码补全、跳转定义或实时错误诊断，需配合 Groovy Language Server（GLS）实现完整 IDE 功能。
1、在终端中执行命令安装 GLS：npm install -g groovy-language-server。
2、确认 Java 运行时已安装且 JAVA_HOME 已配置，GLS 要求 Java 11 或更高版本。
3、在 VSCode 设置中搜索 groovy.serverPath，将其值设为 groovy-language-server（若全局可执行）或指定绝对路径。
4、重新加载窗口（Cmd + Shift + P →“Developer: Reload Window”）。
四、启用 Jenkins Pipeline 专用语法支持
Jenkinsfile 使用 Pipeline DSL，其关键字（如 pipeline、agent、stages）不属于标准 Groovy，需额外注入语义理解能力。
1、安装扩展 Jenkins Pipeline Linter Connector（作者：janjoerke）。
2、在 VSCode 设置中配置 jenkins.pipeline.linter.url 为 Jenkins 实例的 /pipeline-model-converter/validate 接口地址（如 http://localhost:8080/pipeline-model-converter/validate）。
3、确保 Jenkins 服务器已启用 Pipeline Utility Steps 插件并运行中。
4、打开 Jenkinsfile 后，右键选择“Validate Jenkinsfile”即可触发远程语法校验。
五、Gradle 项目结构感知配置
VSCode 默认无法识别 Gradle 构建脚本中的项目依赖与 DSL 扩展（如 plugins、dependencies 块），需借助 Gradle 工具 链建立上下文。
1、在项目根目录下执行 ./gradlew –init –type kotlin（若使用 Kotlin DSL）或确保存在 gradle/wrapper/gradle-wrapper.jar。
2、安装扩展 Gradle for Java（由 Microsoft 提供）。
3、打开命令面板（Cmd + Shift + P），运行 Java: Configure Classpath，选择当前 Gradle 项目。
4、等待“Building workspace”完成，Gradle DSL 元素（如 implementation、testImplementation）将获得类型提示与跳转支持。
