WebStorm 的 .editorconfig 仅在插件启用、文件位于项目根目录且未被 Prettier/ESLint 覆盖时生效；需手动格式化或启用保存时格式化，团队成员须统一重启并验证右下角状态栏标识。
WebStorm 默认识别 .editorconfig，但只在三个条件同时满足时才真正生效：插件启用、文件放在项目根目录、规则没被 Prettier 或 ESLint 覆盖。
EditorConfig 插件是否已启用
2025.3 及之后版本（含当前 2026 年最新版）已内置支持，但部分精简安装或旧版可能仍需手动开启。不启用时，.editorconfig 文件完全被忽略——右下角状态栏不会显示 2 spaces | LF 这类标识。
- 按
Ctrl+Alt+S（Windows/Linux）或Cmd+,（macOS）打开设置 - 进入
Plugins→ 切换到Installed标签页 - 搜索
EditorConfig，确认右侧开关为开启状态；若未列出，需点击Marketplace安装 - 必须重启 WebStorm，否则格式化仍走 IDE 默认规则
.editorconfig 文件位置和最小可用配置
文件必须放在项目根目录（即 package.json 或 tsconfig.json 所在层），WebStorm 不会向上跨项目查找。子目录中可放另一个 .editorconfig 覆盖局部规则，但嵌套过深易导致作用域误判。
-
root = true必须显式声明，否则 WebStorm 可能继承父目录的配置 - 语言特有规则（如
ij_java_brace_style）要加ij_前缀，且仅对对应语言生效；indent_size这类通用项无需前缀 - 注释行（
#开头）会被忽略，但建议保留说明便于协作
最小可用配置示例（保存为项目根目录下的 .editorconfig）：
root = true [*] charset = utf-8 end_of_line = lf insert_final_newline = true trim_trailing_whitespace = true indent_style = space indent_size = 2 [*.md] trim_trailing_whitespace = false
改了 .editorconfig 却没反应？常见原因在这里
WebStorm 从不自动重写已有代码——它只在你主动执行格式化操作时应用规则。所谓“没反应”，90% 是因为格式化动作根本没触发，或者被其他工具劫持。
- 手动格式化快捷键：
Ctrl+Alt+L（Windows/Linux）或Cmd+Option+L（macOS），仅作用于当前文件或选中区域 - 启用「保存时自动格式化」：进
Settings > Actions on Save，勾选Reformat code，并检查下方Only for files matching是否包含*.ts、*.js等实际扩展名 - 如果同时启用了
Prettier（Settings > Languages & Frameworks > JavaScript > Code Quality Tools > Prettier），它的规则优先级高于.editorconfig，此时需关闭Run on save或在Prettier配置中设"editorconfig": true
为什么团队协作中容易踩坑
最隐蔽的问题是「规则被覆盖却不报错」：比如某成员本地开了 Prettier 且未同步配置，他保存后代码按 4 空格缩进，而 Git 提交记录里却显示 .editorconfig 明确写了 indent_size = 2。这种不一致不会引发错误，但会让 PR Review 成为猜谜游戏。
真正起效的关键点只有一个：所有成员的 WebStorm 都必须重启 + 手动触发一次格式化 + 确认右下角状态栏出现 2 spaces | LF。别信「配置写完了就自动生效」这种直觉。
