根本原因是ESLint与Prettier职责未分离,必须禁用ESLint所有格式规则、关闭其自动修复("eslint.format.enable": false)、显式指定"editor.defaultFormatter": "esbenp.prettier-vscode",确保仅Prettier执行保存时格式化。

VSCode保存后代码格式反复抖动、缩进错乱、引号来回切换,根本不是Prettier没配好,而是ESLint和Prettier在同时改同一行代码——必须让Prettier专管格式,ESLint只报错不修。
为什么保存后代码“乱跳”?
典型表现:刚保存是2空格+单引号+无分号;再保存一下变成4空格+双引号+分号;第三次又弹回去。这不是插件失效,是VSCode同时触发了两个动作:
-
editor.formatOnSave调用esbenp.prettier-vscode -
editor.codeActionsOnSave中的"source.fixAll.eslint"调用dbaeumer.vscode-eslint
两者规则冲突(比如Prettier设semi: false,ESLint却配了"semi": ["error", "always"]),结果就是互相覆盖、格式越修越乱。
如何确认当前文件用的是哪个格式化器?
别猜,直接看VSCode实际调用谁:
- 右键 → “格式化文档”,如果弹出菜单让你选,说明
editor.defaultFormatter没锁死 - 按
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(Mac),输入Developer: Toggle Developer Tools打开控制台 - 执行一次格式化(
Shift+Alt+F或保存),切到Output面板 → 选择Log (Window)→ 搜索format - 看到
[Extension Host] Formatting with esbenp.prettier-vscode才对;若出现vscode.typescript-language-features或dbaeumer.vscode-eslint,说明配置没生效
VSCode设置里必须改死的三项
光改.eslintrc.js或.prettierrc没用,VSCode必须明确“谁来动手”。以下三项缺一不可,且布尔值和ID不能错:
-
"editor.formatOnSave": true—— 保持开启,但只让它走Prettier -
"editor.defaultFormatter": "esbenp.prettier-vscode"—— 必须写对ID,不是dbaeumer.vscode-eslint,也不是prettier.prettier-vscode(旧ID已弃用) -
"eslint.format.enable": false—— 关键!必须显式设为false,否则ESLint插件会偷偷自己格式化
顺手删掉所有过时项:prettier.eslintIntegration(v8+已废弃)、eslint.autoFixOnSave(已被codeActionsOnSave替代)。
ESLint配置里怎么彻底禁掉格式规则?
目标是让ESLint完全不管indent、quotes、semi这些事,只报undefined is not a function这类真问题。手动关容易漏,推荐用eslint-config-prettier一键清空:
- 运行
npm install --save-dev eslint-config-prettier - 在
.eslintrc.js的extends数组末尾加上"prettier":{"extends": ["eslint:recommended", "plugin:react/recommended", "prettier"]}(顺序不能错,"prettier"必须最后) - 删掉所有显式写的格式类
rules,例如"semi"、"quotes"、"indent" - 保留
"prettier/prettier": "error"——这不是让ESLint格式化,而是让它把Prettier认为不合规的地方也标出来(比如你忘了配.prettierrc)
复杂点在于:项目级.vscode/settings.json优先级高于全局设置,而eslint-config-prettier是否生效,又取决于它在extends里的位置和是否被其他配置覆盖——这两处最容易被忽略。


















