VSCode代码自动美化是多层规则叠加系统，优先级从高到低为：文件内注释 > 项目配置（如prettier.config.js、.editorconfig）> 语言特定设置 > 用户/工作区settings.json。
VSCode 的代码自动美化不是“设一次就全局生效”，而是多层规则叠加、优先级明确的覆盖系统。搞不清哪条规则在起作用，配置就会互相抵消或静默失效。
为什么 .editorconfig 会强制覆盖 VSCode 的 tabSize 设置
.editorconfig 是独立于 VSCode 的跨编辑器规范文件，一旦存在，它会对 insertSpaces、tabWidth、end_of_line 等基础缩进行为做硬性约束——哪怕你在 VSCode 设置里关了 editor.detectIndentation，也拦不住它生效。
- 它优先级高于用户设置（
settings.json），但低于文件内注释（如// @tabSize 2） - 常见踩坑：团队用了
.editorconfig设tabWidth = 4，但你本地settings.json写了"editor.tabSize": 2，结果打开文件还是 4 空格——不是插件没装，是被.editorconfig覆盖了 - 验证方式：右键编辑器 → “Format Document With…” → 如果显示 “EditorConfig” 为默认项，说明它正在接管基础格式
language-specific settings 如何绕过全局 editor.formatOnSave
你不能只靠 "editor.formatOnSave": true 全局开关来控制所有语言，因为 VSCode 的语言特定设置（language-specific settings）会直接覆盖这个布尔值。
- 例如，在
settings.json中写："editor.formatOnSave": false, "[javascript]": { "editor.formatOnSave": true }, "[typescript]": { "editor.formatOnSave": true }——这样 JS/TS 文件才真正启用保存格式化，而 JSON、Markdown 等则不会误触 - 如果不加语言限定，某些插件（如 YAML 或 TOML 扩展）可能因没有注册 formatter 而报错
Failed to format document: Error: No formatter registered for 'yaml' - 检查当前生效的语言设置：按
Ctrl+Shift+P→ 输入Preferences: Configure Language Specific Settings...→ 选中当前文件类型，就能看到该语言下实际生效的配置
prettier.config.js 与 workspace settings 冲突时谁赢
项目级 Prettier 配置（.prettierrc、prettier.config.js）优先级高于 VSCode 工作区 .vscode/settings.json 中的 prettier.* 字段，但低于文件内注释（如 // prettier-ignore）。
-
prettier.config.js支持动态逻辑（比如根据文件路径返回不同配置），但 CI 或部分远程环境（如 Dev Container）可能不执行 JS 配置，建议纯前端项目优先用 JSON/YAML 版本 - 如果
.vscode/settings.json里写了"prettier.semi": false，但项目根目录有.prettierrc且内容为{"semi": true}，最终生效的是后者 - 调试技巧：打开命令面板 → 运行
Prettier: Show Output Channel，里面会打印出 Prettier 实际加载的配置路径和最终合并后的规则
格式化插件自身配置项（如 prettier.bracketSpacing）为何有时不生效
像 prettier.bracketSpacing 这类插件专属配置项，只有在该插件被真正“选为默认 formatter”时才起作用；否则它们只是躺在设置里，没人读取。
- 必须同时满足两个条件：①
editor.defaultFormatter或对应语言的"[javascript]".editor.defaultFormatter指向esbenp.prettier-vscode；②editor.formatOnSave在该语言下为true - 常见静默失败：你装了 Prettier 插件，也写了
"prettier.bracketSpacing": false，但"[javascript]".editor.defaultFormatter指向的是dbaeumer.vscode-eslint，此时 Prettier 根本不参与格式化，它的配置自然无效 - 右键 → “Format Document With…” → 看当前默认项是不是 Prettier，这是最直接的判断依据
真正难的不是配多少条规则，而是理解每条规则在哪一层、被谁读取、又被谁覆盖。一个 .editorconfig 文件、一个语言特定设置块、一个插件配置项，三者可能同时存在，但只有一条最终落地——漏看其中一层，就等于白配。
