要让 Ctrl+Alt+L 真正按团队规则格式化 Java 代码，须严格配置三重叠加：① Settings → Editor → Code Style → Java（非 General）中设 Tab size=4、取消“Use tab character”、正确配置 Braces placement 和 Wrapping；② 确保文件被识别为 Java 类型（状态栏显示 Java，非 Plain Text）；③ 若启用 .editorconfig 或插件（如 google-java-format 与 CheckStyle-IDEA 不可共存），需统一优先级并禁用冲突项。
IDEA 的自动格式化和规范检查不是“开个开关就能一劳永逸”的功能，它依赖三重配置叠加生效：语言级 Code Style 规则、保存时触发行为（Actions on Save）、以及可选的第三方插件（如 google-java-format 或 CheckStyle-IDEA）。任意一层缺失或冲突，都会导致格式化不执行、只部分生效，或规范提示完全不出现。
怎么让 Ctrl+Alt+L 真正按团队规则格式化 Java 代码
默认的 Ctrl + Alt + L 只会读取当前文件类型对应的 Code Style 配置，而 Java 的配置入口藏得有点深，且容易被忽略细节：
- 必须进入
Settings → Editor → Code Style → Java（不是 “General” 或 “Other Languages”），否则改的是通用缩进，对 Java 无效 - 缩进设置里，“Use tab character” 默认是勾选的，但绝大多数 Java 团队用空格——务必取消勾选，并设
Tab size和Indent均为 4 - 大括号位置（Braces placement）影响 if/for/method 的换行风格，选错会导致
Ctrl + Alt + L把一行 if 拆成四行，却没人意识到是这里配错了 - 如果项目根目录有
.editorconfig，它的优先级高于 IDE 设置；但 IDEA 不会主动提示你“当前配置被 .editorconfig 覆盖”，只能靠你手动比对
保存时自动格式化，为什么有时没反应
勾选了 Reformat code 却没生效，常见原因不是设置没开，而是作用域和时机被卡住了：
- 路径必须是
Settings → Tools → Actions on Save（旧版叫Save Actions），不是在Editor → General下找 - 即使勾选了，若当前文件未被识别为对应语言（比如后缀是
.java但文件编码是 GBK，或文件类型被误判为 Plain Text），IDEA 会跳过格式化 - “Only changed lines” 模式下，如果你只是调整了注释或空行，而没动任何代码逻辑，IDEA 可能判定“无变更”，不触发格式化
- 某些插件（如 Lombok 插件未启用 annotation processing）会导致 AST 解析失败，进而使格式化引擎静默退出，无报错也不执行
CheckStyle 和 google-java-format 插件不能共存
这两个插件都试图接管 Reformat Code 动作，一旦同时启用，会出现互相覆盖、格式化结果不可预测的问题：
-
google-java-format是“强约束型”：它无视你的Code Style配置，只认 Google 官方规范；启用后，Ctrl + Alt + L实际调用的是它的 formatter，连Optimize imports都由它控制 -
CheckStyle-IDEA是“检查型”：它不修改代码，只标红违规项；但如果你勾选了它的 “Auto-correct on the fly”，它就会偷偷调用内置 formatter，和google-java-format冲突 - 二者共存时，
Ctrl + Alt + O（优化 import）可能删掉本该保留的静态导入，因为google-java-format会强制合并静态导入，而 CheckStyle 规则又禁止某些合并方式 - 解决办法只有一个：二选一。需要严格落地规范选
google-java-format；需要灵活检查+人工确认选CheckStyle-IDEA
格式化后代码变“丑”？先查这三项
格式化完发现空行暴增、方法参数全挤在一行、或者 lambda 表达式被强行展开，大概率是以下三个地方之一出了问题：
-
Settings → Editor → Code Style → Java → Wrapping and Braces里的 “Method declaration parameters” 设成了 “Chop down if long” —— 这会让所有长参数列表强制换行，哪怕只超 1 字符 -
Keep when reformatting下的 “Line breaks” 如果没勾选，IDEA 会把人肉加的换行全部抹掉，导致原本清晰的 JSON 初始化变成一行超长字符串 - 使用了
Ctrl + Alt + Shift + L打开高级格式化对话框，但误勾了 “Ensure right margin is not exceeded”，而右边界设得太小（比如 80），会强制拆分所有长语句
最常被忽略的点是：格式化行为永远以当前文件的语言识别为准，而不是后缀名。一个 .java 文件如果被 IDEA 标记为 “Text” 类型（右下角状态栏显示 “Plain Text”），所有 Java 相关格式化规则都不会加载——此时 Ctrl + Alt + L 只做基础缩进，连空格都不加。遇到异常，先看状态栏，再查设置。
