Groovy 在 VSCode 中无开箱即用格式化支持，因语言服务不提供 formatter；需依赖编辑器基础缩进设置、CodeNarc 规则校验及团队约定来保障代码整齐。

Groovy 在 VSCode 中没有开箱即用的格式化支持，editor.formatOnSave 对 .groovy 文件默认无效——这不是你配错了，而是语言服务本身不提供格式化能力。

Groovy 为什么不能像 JavaScript 那样一键格式化

• VSCode 的 Groovy 扩展（如 pkozhevnikov.groovy）只做语法高亮、括号匹配、基础补全，不包含 formatter 实现
• 官方 Groovy 生态中没有类似 prettier 或 black 的通用代码重写器
• groovy -p 或 groovysh 均不输出格式化后的源码，只执行或打印结果

这意味着：你无法靠“装个插件 + 开个开关”就让 Groovy 自动对齐缩进、换行、空格。必须换思路。

怎么让 Groovy 脚本至少“看起来整齐”

真正可行的路径是分层控制：用编辑器基础能力保底线 + 外部工具做风格检查 + 手动约定补位。

• 启用编辑器基础对齐能力：
  • 确保 "editor.detectIndentation": true（自动识别已有缩进）
  • 显式设置 "editor.tabSize": 4 或 2（Groovy 社区常用 4）
  • 开启 "editor.insertSpaces": true（避免混用 Tab 和空格）
• 右下角状态栏确认文件语言模式为 Groovy（不是 Plain Text），否则所有语言相关设置失效
• 不要依赖 Shift+Option+F 全文件格式化——它会静默失败，无报错也无反应

CodeNarc 是唯一能“驱动格式统一”的工具

CodeNarc 不格式化代码，但它能精准定位不一致点，比如：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• Indentation 规则报出缩进错误（非 4 空格、Tab 混用）
• SpaceAfterComma、SpaceBeforeIfParentheses 等规则强制空格位置
• LineLength 限制单行字符数，倒逼换行和缩进重构

实际做法：

• 在项目中添加 build.gradle，启用 CodeNarc 插件并指定 rulesetFiles = files('config/codenarc/codenarc.groovy')
• codenarc.groovy 中启用上述规则，并关闭与格式无关的检查（如命名、复杂度）
• 运行 ./gradlew codenarcMain，根据 HTML 报告逐条修正——这比盲调缩进更可靠

容易被忽略的三个细节

• groovy 命令行工具本身不读取 .editorconfig，所以即使项目根目录有该文件，VSCode 的缩进设置也不会透传给执行过程
• 如果你在 tasks.json 里用 groovy ${file} 运行脚本，它完全绕过 VSCode 的格式化链路，纯靠手写规范
• 多人协作时，仅靠个人 VSCode 设置无法保证对齐效果；必须把 codenarc.groovy 提交进仓库，并在 CI 中运行检查

Groovy 的“格式化”本质是人工约定 + 工具校验 + 持续反馈，没有银弹。别在 settings.json 里反复折腾 defaultFormatter，它对 Groovy 永远为空。