VSCode需安装官方EditorConfig插件且重启才生效；.editorconfig必须置于项目根目录、含root=true，并确保glob匹配路径正确；VSCode设置仅在对应EditorConfig规则缺失时生效。
VSCode 本身不解析 .editorconfig，必须装插件才能生效 —— 这是绝大多数人配置失败的根源。
为什么装了插件还不管用？检查这三件事
EditorConfig 的行为完全依赖 editorconfig/editorconfig 官方插件（VS Code Marketplace 上同名），不是内置功能。常见失效原因：
- 没安装插件，或安装后没重启 VSCode（插件启用需重载窗口）
-
.editorconfig文件没放在项目根目录（即打开的文件夹最顶层），子目录里的不向上查找 - 文件路径匹配规则写错，比如用了
**/*.js却实际编辑的是src/index.ts，而 TS 文件未被 rule 覆盖
root = true 必须写，且只能出现在根配置中
EditorConfig 使用“自上而下继承 + 第一个匹配生效”规则。root = true 告诉编辑器：别再往上找父目录的 .editorconfig 了。漏写会导致意外继承外层配置（比如公司统一 repo 的根配置），覆盖你本地意图。
正确写法示例：
[*.js] indent_style = space indent_size = 2 end_of_line = lf insert_final_newline = true [*.md] max_line_length = 80 trim_trailing_whitespace = true
注意：[*.js] 是 glob 模式，不是正则；indent_size 对 indent_style = tab 无效；end_of_line 在 Windows 上可能被 Git 的 core.autocrlf 干扰，建议 Git 配置保持一致。
VSCode 设置会覆盖 .editorconfig 吗？会，但只在特定条件下
VSCode 的 editor.tabSize、files.insertFinalNewline 等设置，**仅当对应 EditorConfig 规则缺失时才生效**。一旦 .editorconfig 中定义了 indent_size 或 insert_final_newline，VSCode 就强制遵循它，无视用户设置。
这意味着：
- 团队协作时，把格式规则收口到
.editorconfig更可靠，避免开发者各自改设置 - 调试格式问题时，先关掉插件，看是否恢复成 VSCode 默认行为 —— 可快速判断是配置问题还是插件问题
-
editor.detectIndentation设为false可防止 VSCode 自作主张根据文件内容重设缩进，与 EditorConfig 冲突
真正麻烦的不是写错几行配置，而是 .editorconfig 和 Git 行尾、Prettier、ESLint 的规则打架 —— 比如 end_of_line = lf 和 core.autocrlf = true 共存，保存时看似正常，提交后 diff 里全是 ^M。这类问题得连着看三个地方的配置，不能只盯一个文件。
