VSCode格式化器重复出现是因为多个插件注册了同一语言的formatter，导致冲突；需禁用冗余插件、为每种语言单独配置"[language]"块、清空settings.json中prettier.*项，并关闭ESLint格式化以避免与Prettier拉扯。
为什么Format Document With里出现多个格式化器
VSCode本身不带完整格式化能力，所有格式化动作都靠插件注册语言支持来触发。当多个插件同时声明对同一语言（比如.js、.py）有格式化权限时，VSCode就会把它们全列进Format Document With菜单——这不是功能正常，而是冲突已发生。
常见组合包括：Prettier + ESLint（JavaScript）、ms-python.black-formatter + autopep8（Python）、prettier-vscode + vscode-html-languageservice（HTML）。它们不是“可选”，而是“都在抢着干活”。
- 检查方式：打开命令面板（
Ctrl+Shift+P），输入Format Document With，看列表是否干净；若看到两个以上选项，说明至少有一个该禁用 - 根本原因：插件在
package.json中通过contributes.languages和contributes.formatters注册了重叠语言范围，VSCode不做去重 - 右下角语言模式（如显示
JavaScript React）必须和插件实际支持的语言ID严格匹配；Prettier插件对javascript和javascriptreact的处理逻辑可能不同，导致配置看似生效实则被忽略
editor.defaultFormatter设了却没生效的真相
全局设置"editor.defaultFormatter"对多数语言无效——它只在没有更细粒度配置时兜底。VSCode优先查"[javascript]"、"[python]"这类语言块，找不到才 fallback 到全局值。很多人配了全局但.py文件仍乱跳，就是因为缺了"[python]"块。
- 必须为每种目标语言单独写语言块，例如：
"[typescript]"、"[html]"、"[json]" -
python.formatting.provider是Python专用开关，和editor.defaultFormatter并存且不可替代；只设后者而不设前者，ms-python.black-formatter可能根本不启动 - 语言块必须写在项目级
.vscode/settings.json中，用户级设置会被覆盖或忽略（尤其当工作区有settings.json时）
Prettier配置被编辑器设置覆盖
esbenp.prettier-vscode插件默认优先读取VSCode的settings.json里的prettier.*配置项，而不是项目根目录的.prettierrc。所以你在.prettierrc里写了"singleQuote": true，但settings.json里有"prettier.singleQuote": false，那最终生效的就是false。
- 验证方法：在项目根目录运行
npx prettier --check .，看CLI行为是否和编辑器一致；不一致就说明编辑器层配置在干预 - 项目级配置应以
.prettierrc或package.json#prettier为准，建议清空settings.json中所有prettier.*字段，避免干扰 -
prettier.configPath可以强制指定配置文件路径，但需确保路径存在且可读；相对路径从工作区根开始解析，不是从当前文件位置
ESLint和Prettier在保存时互相拉扯
ESLint插件默认开启eslint.format.enable，它会在保存时调用eslint --fix，而Prettier又在同一时刻执行格式化。两者规则不一致（比如semi、quotes），结果就是代码被反复修改：加完分号又被删掉，单引号变双引号再变回来。
- 正确做法是关掉ESLint的格式化能力：
"eslint.format.enable": false，只让它做诊断和source.fixAll类修复 - 用
eslint-config-prettier关闭所有与Prettier冲突的规则，且必须放在extends数组末尾，否则前面的规则会覆盖它 - 不要同时启用
editor.formatOnSave和editor.codeActionsOnSave中的source.fixAll，后者可能在格式化前/后插入额外操作，打乱顺序
