需安装Groovy Language Support扩展、配置groovy.sdkPath路径、设置tasks.json运行任务、安装Java扩展包并配置launch.json启用调试。
如果您希望在VSCode中高效编写和运行Apache Groovy脚本，但缺乏合适的语言支持与调试能力，则可能是由于缺少对应扩展或配置未正确启用。以下是实现该目标的具体步骤：
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装Groovy语言支持扩展
VSCode本身不内置Groovy语法识别，需通过第三方扩展提供高亮、代码补全及错误检查功能。该扩展基于Language Server Protocol（LSP）协议，可与本地Groovy SDK协同工作。
1、打开VSCode，点击左侧活动栏的扩展图标（或按快捷键Ctrl+Shift+X）。
2、在搜索框中输入Groovy Language Support，选择由pivotal团队维护的官方扩展（作者显示为Pivotal Software, Inc.）。
3、点击“安装”按钮，等待扩展下载并启用。
4、重启VSCode以确保扩展完全加载。
二、配置本地Groovy SDK路径
要使VSCode识别Groovy语法并支持语义分析，必须明确指定已安装的Groovy SDK主目录。该路径将被语言服务器用于解析AST、校验语法及提供类型提示。
1、在终端中执行命令groovy -version，确认Groovy已安装并记录其安装路径（例如/usr/local/opt/groovy/libexec）。
2、在VSCode中按下Cmd+, 打开设置界面，切换至“Settings (JSON)”标签页。
3、在settings.json文件中添加如下行："groovy.sdkPath": "/usr/local/opt/groovy/libexec"，路径需替换为实际Groovy SDK根目录。
4、保存文件后，重新打开任意.groovy后缀文件，观察右下角状态栏是否显示Groovy语言模式已激活。
三、配置Task以运行Groovy脚本
VSCode可通过自定义task直接调用groovy命令执行脚本，无需切换至终端。该方式依赖系统PATH中存在groovy可执行文件，并支持参数传递与输出捕获。
1、在项目根目录下创建文件夹.vscode（若不存在）。
2、在该文件夹内新建文件tasks.json，内容如下：
3、在tasks.json中填入标准task结构，其中command字段设为groovy，args字段包含"${file}"以动态传入当前编辑文件路径。
4、按下Cmd+Shift+P，输入“Tasks: Run Task”，选择“groovy-run”并回车，观察集成终端输出结果。
四、启用Groovy调试支持
调试Groovy脚本需借助Java调试器，因Groovy编译为JVM字节码运行。VSCode Java Extension Pack中的Debugger for Java可配合Groovy插件完成断点设置与变量监视。
1、安装VSCode扩展Extension Pack for Java（含Debugger for Java）。
2、在项目根目录创建.vscode/launch.json文件，配置type为java，request为launch，mainClass字段留空，使用projectName与console参数适配Groovy启动流程。
3、在Groovy脚本中设置断点（点击行号左侧空白区域），按F5启动调试会话。
4、确认调试控制台显示Groovy脚本执行流程，且变量窗格可展开查看对象属性与方法。
