VSCode怎么运行Groovy代码 VSCode配置Groovy环境步骤

先说几个核心判断：VSCode 本身并不会变魔术，它没法凭空执行 Groovy 代码。想让编辑器跑起来，要么你明确告诉它 Groovy 可执行文件在哪儿，要么借助任务系统调用系统的 groovy 命令。否则，点一万次“运行”按钮，结果要么报错，要么毫无反应。

所以，在动手之前，先搞清楚一个前提：你的终端里到底能不能直接调用 groovy？

确认 groovy 命令已在终端可用

这是所有后续操作的基础，没什么可讨价还价的。VSCode 的任务系统、Code Runner 扩展、甚至调试器，通通依赖系统 PATH 环境变量里能找到 groovy 这个可执行文件。

• 打开终端，执行 which groovy（macOS/Linux）或 where groovy（Windows）。如果返回一个路径（比如 /opt/homebrew/bin/groovy），恭喜，第一步过关了。
• 如果命令没输出？那就先装 Groovy。推荐用 sdk install groovy（SDKMAN! 管理工具）或 brew install groovy（Homebrew），两条路都走得通。
• 别忘了，Groovy 本质上是跑在 JVM 上的，所以 JA VA_HOME 环境变量必须正确设置，并且指向 JDK 11 或更高版本。不然 groovy 启动就会卡在 ERROR: Environment variable JA VA_HOME has not been set 这类报错上。
• 最后，执行 groovy -v 看看版本信息，确认一切正常。

用 Code Runner 快速一键运行（适合脚本片段）

如果你只是写点临时脚本、跑个小片段，Code Runner 无疑是最省事的方案。它轻量、直接，基本就是装好就用。当然缺点也明显：不支持调试、不支持传参、也不支持复杂的类路径配置。

• 安装扩展 Code Runner（作者 Jun Han，别搞错版本）。
• 打开 VSCode 设置，搜索 code-runner.executorMap，然后点“在 settings.json 中编辑”。
• 添加或修改 Groovy 的条目，就像这样：

  "groovy": "groovy \"$fileName\""

  注意双引号要转义，Windows 下可以用 "groovy" 包裹。
• 保存后，打开一个 .groovy 文件，点击右上角的 ▶️ 按钮，或者按快捷键 Ctrl+Alt+N（Win/Linux） / Cmd+Option+N（macOS），就能看到输出结果了。
• 有个坑要提醒一下：如果脚本里含中文，或者文件路径带空格，Code Runner 的默认命令可能会崩。这时候建议改用 tasks.json 方案，并且记得用引号把 "${file}" 包起来。

用 tasks.json 运行（推荐用于工程化脚本）

相比 Code Runner，tasks.json 的可控性要好得多。它支持自定义参数、指定工作目录、集成错误解析，甚至能和 VSCode 的任务系统深度绑定。适合那些要跑测试、做 CI 前置检查、或者执行工具类脚本的场景。

• 在项目根目录下创建 .vscode/tasks.json（如果没有的话）。
• 填入下面这个标准模板：

  {
    "version": "2.0.0",
    "tasks": [
      {
        "label": "groovy-run",
        "type": "shell",
        "command": "groovy",
        "args": ["${file}"],
        "group": "build",
        "presentation": {
          "echo": true,
          "reveal": "always",
          "focus": false,
          "panel": "shared",
          "showReuseMessage": true,
          "clear": true
        },
        "problemMatcher": []
      }
    ]
  }

• 保存后，按 Cmd+Shift+P 调出命令面板，输入 `Tasks: Run Task`，选择 groovy-run` 就执行了。
• 优势很明显：可以传额外参数，比如 `"args": ["--config", "dev.conf"]`；可以把常用任务绑定快捷键；还能配置 problemMatcher 捕获错误信息（不过得单独配 Groovy 的匹配规则）。