必须禁用eslint格式能力、明确指定prettier为默认格式化器，并用code --disable-extensions验证插件冲突；vscode中需配置"editor.formatonsave":true、"editor.defaultformatter":"esbenp.prettier-vscode"、"eslint.format.enable":false。
VSCode格式化报错，90%不是配置写错了，而是多个插件在后台抢着干活——比如 esbenp.prettier-vscode 和 dbaeumer.vscode-eslint 同时监听 editor.formatOnSave，一个刚加了分号，另一个立刻删掉，最后抛出 Range is not valid 或直接卡住。
怎么快速确认是插件冲突？
别改配置、别重装，先做最干净的验证：
- 终端执行
code --disable-extensions，启动无插件环境 - 打开一个 .html 或 .js 文件，编辑后按
Ctrl+S—— 如果此时格式化正常，说明 100% 是插件冲突 - 顺手按
Ctrl+Shift+I打开开发者工具，切到 Console 标签页，留意是否刷出Command 'editor.action.formatDocument' is already registered或Conflict detected
为什么 editor.defaultFormatter 设了还是不生效？
设了 ≠ 生效。VSCode 会按语言类型查专属设置，而你可能只改了全局默认值，却没填对语言专属项：
- 打开设置（
Ctrl+,），搜editor.defaultFormatter - 点右上角“⚙️”→“Edit in settings.json”，找到
"[html]"或"[javascript]"这类语言块 - 必须显式写成：
"[html]": {"editor.defaultFormatter": "esbenp.prettier-vscode"}，不能留空，也不能写成prettier或prettier-vscode - 如果项目里有
prettier.config.js，确保它包含plugins: ['prettier-plugin-html']，否则 Prettier 直接跳过 .html 文件
高频冲突组合：Prettier + ESLint + EditorConfig 怎么共存？
这三者都试图控制缩进、引号、空行，不协调就会互相覆盖。不是全关，而是明确分工：
- 只让
esbenp.prettier-vscode负责格式化，其他两个退为辅助角色 - 在
settings.json中关掉 ESLint 的格式能力："eslint.format.enable": false - 卸载或禁用
EditorConfig插件（如EditorConfig.EditorConfig），改用.editorconfig文件仅作团队约定，不参与自动格式化 - ESLint 配置中加
"extends": ["eslint:recommended", "prettier"]，且"prettier"必须放在extends数组末尾，否则会被前面规则覆盖
格式化卡死或反复触发怎么办？
这不是性能问题，是多个 formatter 在 save 事件里嵌套调用，形成死循环：
- 检查
settings.json是否同时开了："editor.formatOnSave": true和"eslint.autoFixOnSave": true（已废弃，但旧配置可能残留） - 禁用
eslint.autoFixOnSave，改用保存后手动运行ESLint: Fix all auto-fixable Problems命令 - 如果用了 Volar（Vue3），确认已禁用 Vetur，并在设置中加：
"vue.preferences.useVolarForVue3": true，否则两个语言服务争抢 .vue 文件解析权 - 某些插件（如旧版
ms-python.python）即使禁用，也可能残留初始化逻辑；若怀疑它，直接删扩展目录：rm -rf ~/.vscode/extensions/ms-python.python-*（macOS/Linux）
真正难处理的不是“哪个插件该禁”，而是某个插件明明没启用，却还在 Extension Host 进程里挂着旧实例——这时候 Developer: Show Running Extensions 比设置面板更可信，看 “Activation time” 是否超 1000ms，或状态是不是 “Activation failed”。
