editorconfig 本身不能统集团队风格，它只管基础格式层，必须配合插件+正确路径+明确优先级才生效；团队真正统一靠配置落地、工具协同与人对齐。
EditorConfig 本身不能“统集团队风格”，它只管基础格式层（缩进、换行、编码、末尾空格），且必须配合插件+正确路径+明确优先级才生效。团队真正统一，靠的是配置落地 + 工具协同 + 人对齐。
VSCode 读不到 .editorconfig？先确认这三件事
不是“装了插件就自动好”，而是三个硬性条件缺一不可：
-
.editorconfig文件必须放在你用 VSCode 打开的**工作区根目录**（即左侧资源管理器顶部显示的那个文件夹下），不是子包里、不是父目录里； - 必须安装并启用官方插件
EditorConfig for VS Code（发布者是EditorConfig），右下角状态栏要能看到EditorConfig字样； - 文件第一行必须写
root = true，否则 VSCode 会一路向上找（比如找到你家目录下的全局配置），导致项目规则被意外覆盖。
验证方式：打开任意源码文件（如 index.js），看右下角是否显示类似 Spaces: 2、LF、UTF-8 的标识。没有？说明没加载成功。
indent_size 设了 2 却还是 4 格？别让 settings.json 悄悄覆盖
VSCode 的用户或工作区设置（settings.json）中如果写了 "editor.tabSize": 4 或 "editor.insertSpaces": false，会直接压过 .editorconfig 的 indent_size 和 indent_style。
- 真实表现：你配了
indent_style = space和indent_size = 2，但按 Tab 键却插入 4 个空格 → 很可能是editor.tabSize在起作用； - 解决办法：删掉
settings.json里所有和缩进相关的手动设置（editor.tabSize、editor.insertSpaces、editor.detectIndentation），把控制权完全交给.editorconfig； - 验证命令：按
Ctrl+Shift+P→ 输入Developer: Toggle Developer Tools→ 在 Console 里执行editor.getModel().getOptions().tabSize，返回值应与.editorconfig中的indent_size一致。
JavaScript/TypeScript 文件不走 end_of_line 规则？显式声明语言范围
end_of_line = lf 这类规则默认只对新创建或保存的文件生效，且 VSCode 对 JS/TS 文件默认忽略该规则——除非你在 .editorconfig 中单独为它们声明段落。
- 错误写法：
[*]段落里写了end_of_line = lf，但index.js保存后仍是CRLF； - 正确写法：必须加一段
[*.{js,ts}]或[*.js]，把规则显式绑定到文件类型； - 更稳妥的做法：在
prettier.config.js里也设endOfLine: 'lf'，并确保prettier.useEditorConfig为true（默认是true，但旧版或自定义配置里可能关了）； - 注意：已有文件的换行符不会被自动转换，需手动在右下角点击
CRLF→ 切成LF→ 再保存一次。
为什么团队合并还总因空格/换行冲突？漏掉了这三个关键配置
多数人只配了缩进，但引发 Git 冲突最多的其实是“看不见”的细节：
-
trim_trailing_whitespace = true：避免提交末尾空格，但得关掉 VSCode 自带的“保存时 trim”功能，否则和.editorconfig双重触发，可能误删有效空格； -
insert_final_newline = true：防止 Linux/macOS 下因缺结尾换行符导致 diff 异常，尤其影响 shell 脚本和配置文件； -
charset = utf-8：强制统一编码，避免 Windows 记事本改文件后出现乱码，再被 Git 当作二进制文件处理。
这些配置必须提交进仓库，并写进 CONTRIBUTING.md —— 否则新人 clone 项目后，即使插件装了、文件放对了，也可能因为没意识到要手动启用 EditorConfig 插件而失效。
