VSCode Groovy 开发需安装 pivotal.groovy 扩展以支持基础语法；配置 Gradle for Java 扩展实现 DSL 智能感知；安装 Jenkins Pipeline Linter Connector 并配置 Jenkins 地址以支持 Pipeline 语法；通过 SDKMAN 安装 Groovy、Code Runner 和 Java Debug Extension 实现运行与调试；最后配置 groovy.json 代码片段提升 Jenkinsfile 和 Gradle 脚本编写效率。
如果您正在使用 VSCode 进行 Groovy 脚本开发，尤其是面向 Gradle 构建配置或 Jenkins Pipeline 脚本编写，则可能遇到语法高亮缺失、代码补全失效、Groovy DSL 识别不准等问题。以下是针对该场景的多种配置与优化方案：
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装核心 Groovy 扩展
VSCode 默认不支持 Groovy 语言特性，需通过扩展提供基础语法支持、括号匹配、缩进识别等功能。该扩展是后续所有高级功能的前提。
1、打开 VSCode，点击左侧活动栏的扩展图标（或按 Cmd+Shift+X）。
2、在搜索框中输入 Groovy Language Support，选择由 pivotal 发布的官方扩展（ID: pivotal.groovy）。
3、点击“安装”，安装完成后重启 VSCode。
二、配置 Gradle DSL 智能感知
Gradle 构建脚本（build.gradle 或 build.gradle.kts 中的 Groovy 版本）依赖于 Gradle 的 API 类型信息，仅靠语法扩展无法实现方法提示与属性跳转。需借助 Gradle 的构建模型导出能力。
1、确保项目根目录下存在 gradlew 文件，并已赋予执行权限（chmod +x gradlew）。
2、在终端中进入项目根目录，执行：./gradlew --init-script init-idea.groovy idea（需提前准备含 ProjectModel 导出逻辑的 init-idea.groovy）。
3、安装 Gradle for Java 扩展（Microsoft 提供），启用后可在 Groovy 文件中识别 project、dependencies 等 DSL 关键字。
三、启用 Jenkins Pipeline 语法支持
Jenkinsfile 使用 Groovy 编写但包含大量 Jenkins 特有步骤（如 pipeline、stage、sh），需注入 Jenkins 全局变量与步骤元数据。
你是 TypeScript 项目架构专家，专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链（pnpm、Vite、Next.js）、类型
1、安装 Jenkins Pipeline Linter Connector 扩展（作者：janjoerke）。
2、在 VSCode 设置中搜索 jenkins.pipeline.linter.url，将其值设为运行中的 Jenkins 实例地址，例如：http://localhost:8080。
3、确保 Jenkins 已启用 Pipeline Utility Steps 插件，并在 VSCode 中打开任意 Jenkinsfile，等待右下角显示 Jenkins Linter Ready 提示。
四、自定义 Groovy 运行与调试环境
直接在 VSCode 中执行 Groovy 脚本（如 Jenkins 共享库测试脚本或 Gradle 配置片段）需要本地 Groovy 运行时及调试器集成，避免频繁切换终端。
1、通过 SDKMAN 安装 Groovy：sdk install groovy，并确认 groovy -version 可正常输出。
2、安装 Code Runner 扩展，在设置中找到 code-runner.executorMap，添加 Groovy 配置项："groovy": "groovy /$fileName"。
3、创建 .vscode/launch.json，添加 Groovy 调试配置，使用 Java Debug Extension 并指定 groovy.lang.GroovyShell 作为主类。
五、设置 Groovy 专属代码片段与模板
高频编写的 Jenkins Pipeline 结构或 Gradle 插件配置存在固定模式，手动输入易出错且低效。通过用户代码片段可一键插入标准化结构。
1、打开命令面板（Cmd+Shift+P），输入 Preferences: Configure User Snippets，选择 New Global Snippets file，命名为 groovy.json。
2、在文件中添加 Jenkins Pipeline 模板片段，key 为 jenkins-pipeline，prefix 为 pipe，body 包含 pipeline { agent any; stages { stage('Build') { steps { sh 'echo building' } } } }。
3、在 Groovy 文件中输入 pipe 后按 Tab 键，即可展开完整结构。
