遇到JetBrains系列IDE里代码格式化不生效，最容易踩的坑不是“没开功能”，而是触发方式、格式化范围、规则来源三者没对齐：你按了快捷键却实际调用了别的格式化器，你开启了保存自动格式化但作用域把文件排除了，或者项目里有.editorconfig与Prettier把IDE的Code Style覆盖了。下面按先定位不生效原因，再把规则落到可复用配置的顺序来处理。

　　一、JetBrain代码格式化不生效怎么办

　　先把“不生效”具体化：是按【Reformat Code】完全没变化，还是只改了一部分行，还是保存时不触发。把现象定清楚，后面每一步都能立刻验收。

　　1、确认动作

　　在编辑器里按Ctrl+Alt+L触发【Reformat Code】；如果你是想保存时自动格式化，打开设置Ctrl+Alt+S进入【Tools】→【Actions on Save】，确认已勾选【Reformat code】。

　　2、检查范围

　　在【Tools】→【Actions on Save】里把【Reformat code】的配置打开，重点看是否启用了【Configure scope】把当前目录或文件排除了，同时确认你选择的是格式化整文件还是仅格式化改动行，很多人以为没生效其实只是只处理了改动行。

　　3、看语言

　　打开设置Ctrl+Alt+S进入【Editor】→【Code Style】，在右侧先选对语言分组，例如Java、Kotlin、Python、HTML、JavaScript；如果语言没选对，改了半天规则也不会作用到当前文件。

　　4、查覆盖

　　在项目根目录或子目录找是否存在.editorconfig；一旦存在，EditorConfig里能识别的规则会优先于IDE的Code Style，表现就是你在IDE里改缩进但格式化仍按.editorconfig走。需要临时验证时，可在设置里进入【Editor】→【Code Style】相关区域关闭EditorConfig支持再对比一次结果。

　　5、查外部格式化器

　　前端相关文件经常由Prettier接管：确认设置中【Prettier】是否被配置为默认格式化器，部分文件按Ctrl+Alt+L会调用Prettier而不是IDE内置规则；同时检查Prettier是否启用了保存自动运行，避免两套规则来回覆盖导致看起来像没生效。

　　6、查只读与片段

　　确认当前文件不是只读状态，也不是只选中了很小的片段在格式化；建议先在编辑器里按Ctrl+A全选，再触发一次Ctrl+Alt+L，用整文件结果判断规则是否真正生效，避免被选区范围误导。

　　二、JetBrain代码格式化规则怎么配置

　　规则配置建议分两层：团队统一口径用.editorconfig或共享Scheme，个人偏好留在本机Scheme。这样既能统一缩进与换行，又不会把每个人的细枝末节都绑死。

　　1、设缩进

　　打开设置Ctrl+Alt+S进入【Editor】→【Code Style】→选择语言，在Tabs and Indents里设置Indent与Continuation Indent，统一用Spaces还是Tabs，并把Tab size与Indent size设为团队一致值。

　　2、设换行

　　仍在【Editor】→【Code Style】里进入Wrapping and Braces或相关换行分组，先统一if、for、method call、chained call的换行策略，再回头微调空行数量，避免一开始就改得过细导致团队争议。

　　3、设导入

　　在【Tools】→【Actions on Save】里按需勾选【Optimize imports】，让保存时顺手整理import；如果你们更希望只在提交前统一整理，也可以不在保存时启用，而是要求在提交前手动执行一次【Optimize Imports】。

　　4、设保存动作

　　进入【Tools】→【Actions on Save】勾选【Reformat code】，点配置项选择是否只处理改动行，并用【Configure scope】排除生成代码目录与第三方库目录，避免保存时把不该动的文件改乱。

　　5、设共享方案

　　在【Editor】→【Code Style】点击Scheme操作按钮，使用【Import Scheme】导入团队提供的Code Style XML或Eclipse Profile；需要反向输出给团队时，用【Export】导出为IDEA方案或EditorConfig格式，便于纳入版本管理。

　　三、JetBrain格式化与EditorConfig冲突怎么处理

　　当你们既用IDE规则又用.editorconfig，冲突几乎不可避免。处理原则是把必须统一的写进.editorconfig，把语言细节留给各语言的格式化器或团队Scheme。

　　1、先定主规则源

　　团队如果以.editorconfig为准，就把缩进、换行符、文件末尾换行、编码等基础项固定在.editorconfig里，IDE内Code Style只做补充，不再作为统一依据。

　　2、再做分目录

　　需要测试代码与生产代码不同风格时，在对应子目录放第二份.editorconfig，分别约束不同范围文件，避免一份文件里堆太多例外规则。

　　3、前端单独管

　　JS、TS、Vue、React等如果以Prettier为准，就在IDE里把Prettier配置指向项目内的配置文件，并明确哪些文件由Prettier接管，哪些仍用IDE内置格式化，减少互相覆盖。

　　4、做一次验收

　　每次改完规则，用同一份样例文件做三次验证：按Ctrl+Alt+L格式化一次，保存触发一次，重新打开IDE再格式化一次；三次结果一致再提交规则文件，避免只在当前会话里看起来正常。

　　总结

　　JetBrain代码格式化不生效时，先确认触发的是【Reformat Code】还是【Actions on Save】，再检查是否只处理改动行与是否被【Configure scope】排除；规则怎么配则回到【Editor】→【Code Style】按语言设置，并用Scheme导入导出固化团队口径。项目里有.editorconfig或Prettier时，要把谁是主规则源定下来，避免两套规则互相覆盖，格式化看起来就会稳定很多。