IDEA中应导入Google官方XML配置而非使用idea-google-java-format插件，否则会导致快捷键失效、无法联动Save Actions等；导入后须手动调整参数换行、括号空格及注释空行三项，并配置import分组排序、去除行尾空格、确保文件末尾换行。
IDEA 里直接导入 Google Java Style 是可行的，但别指望一键完美适配——它和 IDEA 默认格式化引擎存在几处关键冲突，必须手动调校。
Google Java Style 的 idea-google-java-format 插件不推荐用
这个插件底层调的是 google-java-format 命令行工具，会绕过 IDEA 自带的代码格式化（Reformat Code），导致：
• 快捷键 Ctrl+Alt+L 失效或行为不一致
• 无法与 Save Actions 插件联动（比如保存时自动格式化）
• 不支持实时编辑时的智能换行、缩进提示等 IDE 原生体验
• 导入后 Code Style → Java 设置面板多数选项被锁定，调试困难
正确做法：用官方 XML 配置文件导入 + 手动微调
Google 官方维护了一份 IDEA 兼容的代码风格 XML：
• 下载地址是 https://github.com/google/styleguide/blob/gh-pages/intellij-java-google-style.xml
• 在 IDEA 中： File → Settings → Editor → Code Style → Java → Scheme → Import Scheme → IntelliJ IDEA code style XML
• 选中下载好的 intellij-java-google-style.xml
导入后必须检查并修改以下三项（否则格式化结果和 Google 官方指南不一致）：
• Wrapping and Braces → Method declaration parameters → Wrap when long 改为 Chop down if long
• Spaces → Within → Parentheses 取消勾选（Google 风格要求 if (x)，不是 if ( x )）
• Blank Lines → Keep maximum blank lines → In comments 设为 1（默认是 2，会多出空行）
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
为什么 import 顺序总不对？
Google 风格强制要求 import 分组且按字母排序，但 IDEA 默认不启用分组规则：
• 进入 Settings → Editor → Code Style → Java → Imports
• 勾选 Import static members in groups
• 点击 Import Layout…，按顺序填入：import static *import android.*import com.google.*import *
• 最后勾选 Sort imports 和 Optimize imports on the fly
保存时自动格式化容易漏掉 Google 特有规则
即使配置了 Save Actions 插件，它默认只触发 IDEA 原生格式化逻辑，不会强制执行 Google 要求的：
• Line comment at first column（行注释顶格）
• No trailing whitespace（行尾空白自动删）
• Final newline at file end（文件末尾必须换行）
这些得单独开启：
• Settings → Editor → General → Strip trailing spaces on Save → 选 All
• Settings → Editor → General → Ensure newline at file end on Save → 勾选
• 行注释顶格问题无全局开关，需在 Code Style → Java → Code Generation → Comment Code 中确认 Line comment 模板不含前置空格
真正麻烦的不是导入，而是那些藏在 Wrapping and Braces 或 Imports → Import Layout 里的细项——改错一个，Ctrl+Alt+L 就可能把团队代码格式搞乱。建议把最终配置导出为 codestyles.xml 文件，放进项目根目录，让所有人统一加载。
