editorconfig 文件必须放在 vscode 工作区根目录且需安装官方插件才生效，root = true 防止向上查找干扰，匹配模式需覆盖实际文件类型，格式化插件可能覆盖其缩进设置。

EditorConfig 文件必须放在项目根目录才能生效

VSCode 不会自动向上查找 .editorconfig，只认当前打开文件所在工作区的根目录下是否存在该文件。如果项目是多层嵌套（比如用 code ./packages/foo 单独打开子包），而 .editorconfig 在更上层，VSCode 就完全无视它。

实操建议：

• 确保 .editorconfig 放在 VSCode 左侧资源管理器顶部显示为「文件夹名」的那个路径下
• 用终端执行 pwd 确认当前工作区路径，再检查该路径下是否有 .editorconfig
• 如果团队用 monorepo，每个子包需要独立配置，或统一在最外层配 + 设置 root = true

indent_style 和 indent_size 对不同语言可能被插件覆盖

VSCode 自身读取 .editorconfig 仅控制基础缩进、换行、空格等，但像 Python 的 black、JavaScript 的 Prettier 这类格式化工具会直接忽略 .editorconfig 中的缩进设置，按自己规则重写。

实操建议：

• 先关掉所有格式化插件（比如禁用 esbenp.prettier-vscode），验证 .editorconfig 是否真起作用
• 若需共存，Prettier 要显式启用 prettier.useEditorConfig 设置（默认为 true，但某些旧版本或自定义配置里可能关了）
• indent_style = tab 时，VSCode 的 editor.insertSpaces 必须设为 false，否则编辑器行为和配置冲突

VSCode 需要安装 EditorConfig 插件才解析 .editorconfig

VSCode 原生不支持 .editorconfig —— 这点很多人误以为是内置功能。没装插件时，改了文件也完全不影响缩进、保存行为。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

实操建议：

• 必须安装官方插件：EditorConfig for VS Code（作者是 EditorConfig 团队）
• 安装后重启 VSCode 或重新打开文件夹，插件右下角状态栏会出现 EditorConfig 标识
• 如果状态栏没显示，用快捷键 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（Mac）输入 Developer: Toggle Developer Tools，看 Console 是否报错 Failed to load editorconfig

root = true 是防止父目录配置干扰的关键开关

没有 root = true，VSCode 会逐级向上找 .editorconfig，直到磁盘根目录。如果你家目录下有个全局 .editorconfig，而项目里没写 root = true，那项目就会被意外覆盖。

实操建议：

• 每个项目的 .editorconfig 第一行必须是 root = true
• 别依赖「项目里有配置就自动停止向上找」——VSCode 的 EditorConfig 插件不会这样判断，它严格遵循 EditorConfig 规范里的查找逻辑
• 可以用 editorconfig -f /path/to/file.js（需全局装 editorconfig CLI）验证实际生效的配置来源

最容易被忽略的是：即使插件装了、文件放对了、root = true 写了，只要当前文件类型没被 [*.js] 这类模式匹配上，配置照样不生效。检查你的 match 模式是否漏写了 .ts、.vue 或大小写变体（比如 [*.JS] 不匹配 index.js）。