WebStorm 默认识别 .editorconfig，但需满足三个前提：插件已启用、文件置于项目根目录、规则未被 Prettier 等工具覆盖；2025.3+ 版本内置支持，旧版需手动启用插件并重启，root = true 必须显式声明且文件位置准确，右下角状态栏显示“2 spaces | LF”为生效标志。
WebStorm 默认识别 .editorconfig，但必须满足三个前提：插件启用、文件在项目根目录（或对应子目录）、规则未被 Prettier 等工具覆盖。
EditorConfig 插件是否已启用
WebStorm 2025.3 及之后版本默认内置 EditorConfig 支持，但部分旧版或精简安装可能未激活。不启用插件时，.editorconfig 文件会被完全忽略——右下角状态栏不会显示 2 spaces 或 LF 等标识。
- 按
Ctrl+Alt+S（Windows/Linux）或Cmd+,（macOS）打开设置 - 进入
Plugins→ 切换到Installed标签页 - 搜索
EditorConfig，确认其右侧开关为开启状态（若无此插件，需手动安装） - 重启 WebStorm 才能生效（仅启用不重启，文件仍按 IDE 默认样式渲染）
.editorconfig 文件位置和基础写法
文件必须放在项目根目录（即 package.json 所在层），否则 WebStorm 不会向上查找；子目录中可放另一个 .editorconfig 覆盖局部规则，但不推荐嵌套过深——容易误判作用域。
- 最小可用配置示例（保存为项目根目录下的
.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
-
root = true必须显式声明，否则 WebStorm 可能继续向上查找父目录的配置，导致意外继承 - 语言特有规则（如
ij_java_brace_style）要加ij_前缀，且仅对支持该选项的语言生效；indent_size这类通用项无需前缀 - WebStorm 不解析注释行（
#开头），但建议保留说明便于协作
为什么改了 .editorconfig 却没反应
最常见原因是「格式化动作未触发」或「被其他工具劫持」。WebStorm 从不自动重写已有代码——它只在你主动执行格式化操作时应用规则。
- 手动格式化快捷键：
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中的缩进、换行等基础项仍有效，但括号风格、分号、引号等会被.prettierrc覆盖 - 右下角状态栏是唯一可信反馈源：打开任意
.ts文件，看是否显示UTF-8 | LF | 2 spaces；若显示4 spaces或Tab，说明.editorconfig未加载成功
团队协作时怎么确保 .editorconfig 真生效
它本身不是魔法文件，生效依赖两个隐性条件：所有成员用的编辑器都支持 EditorConfig，且项目里没有更高优先级的本地覆盖设置。
- 禁止在
Settings > Editor > Code Style > TypeScript里手动调缩进为 4 —— 这会和.editorconfig冲突，且无法提交给队友 - 团队应统一禁用「Reformat on save」配合 ESLint 的
--fix，二者混用会导致同一行被反复修改（比如 ESLint 加分号，WebStorm 又删掉） - CI 流程中可用
editorconfig-checker或prettier --check验证，但注意：WebStorm 的.editorconfig解析行为与 CLI 工具不完全一致，关键还是以 IDE 实际渲染为准 - 真正容易被忽略的是
root = true的位置——如果项目是单仓多包结构（如packages/foo/），而.editorconfig放在packages/目录下，那么foo子项目将读不到它
