切换分支后Prettier/ESLint不生效,主因是editor.defaultFormatter未适配新分支、规则配置文件(如.eslintrc.js、.prettierrc)缺失或未提交、工作区未信任、语言模式错误,以及git worktree下依赖未单独安装。

切换分支后 Prettier/ESLint 不生效,先看 editor.defaultFormatter
VSCode 切换分支时,editor.defaultFormatter 设置不会自动变更——它只读取当前工作区(即打开的文件夹)的 .vscode/settings.json 或全局设置。如果目标分支没配这个字段,或配错了扩展 ID,格式化就会“消失”。常见错误是:新分支里 .vscode/settings.json 被删了、没提交,或仍写着旧扩展名(比如 esbenp.prettier-vscode 没装,却设成了默认)。
检查方法:打开命令面板(Ctrl+Shift+P),输入 Format Document With,看下拉列表是否为空或只有 None。如果是,说明 VS Code 找不到可用的格式化提供者。
- 确认该分支根目录已安装对应依赖:
npm install prettier --save-dev或npm install eslint --save-dev - 确认
.vscode/settings.json中存在且正确:"editor.defaultFormatter": "esbenp.prettier-vscode"(Prettier)或"dbaeumer.vscode-eslint"(ESLint) - 若用 ESLint,还要检查
eslint.validate是否包含当前语言,例如:["javascript", "typescript"]
不同分支用了不同规则文件,.eslintrc.js 和 .prettierrc 必须在分支内
VSCode 的语言服务器(如 ESLint、Prettier)只认**当前工作区根目录下**的配置文件。切换分支后,如果新分支没有 .eslintrc.js、.prettierrc.json 或 .editorconfig,规则就无法加载——不是插件坏了,是根本没东西可读。
典型现象:主分支格式化正常,切到 feature/css-reset 后 CSS 文件不再自动修复;原因是该分支没放 .stylelintrc.json,也没在 package.json 里声明 stylelint 配置。
- 所有规则配置文件(
.eslintrc.*、.prettierrc.*、.stylelintrc.*、.editorconfig)必须随代码一起提交到对应分支 - 避免用全局配置覆盖项目级规则:VS Code 默认优先读取项目根目录配置,而非用户设置里的
eslint.options - 验证方式:在目标分支中打开终端,运行
npx eslint --print-config src/index.js(ESLint)或npx prettier --find-config-path src/index.js(Prettier),看是否返回路径
Git Worktree 场景下,每个工作树要独立装依赖和插件
用 git worktree 开多个分支窗口时,每个工作树是独立路径,但共享同一个 Git 仓库对象库。VSCode 会把每个工作树当作一个**全新工作区**处理——这意味着:插件需手动启用(即使已装)、node_modules 要单独 npm install、.vscode/settings.json 也得各自存在。
最容易忽略的是依赖缺失:比如你在 main 分支的窗口里装了 prettier,但 worktree 对应的 feature/login 目录下没 node_modules/prettier,VS Code 就调用失败,报错 Failed to load module 'prettier'。
- 进入每个 worktree 根目录,执行一次
npm install(或yarn install) - 确保每个 worktree 下都有
.vscode/settings.json,且内容与主分支一致 - 不要依赖“继承全局插件”:VS Code 插件作用域是按工作区激活的,不是按用户
格式化失效的隐藏原因:工作区未被信任或语言模式不对
VSCode 1.90+ 加入了“工作区信任”机制。如果切换到的分支所在文件夹被标记为“不受信任”,部分扩展(尤其是 ESLint、Stylelint)会直接禁用,连错误提示都不显示,更别说自动修复了。另一个低级但高频的问题是:文件右下角语言模式显示为 Plain Text 而非 JavaScript 或 CSS,导致格式化工具压根不响应。
- 点击 VS Code 右下角状态栏的语言标识(如
JavaScript),选择正确语言模式;也可用快捷键Ctrl+K M手动切换 - 检查左下角是否有黄色盾牌图标,提示 “This workspace is not trusted”;点击后选择 “Trust Workspace”
- 确认文件后缀与语言匹配:比如
index.tsx要识别为TypeScript React,否则 ESLint 不会校验 JSX 规则
真正卡住人的往往不是配置本身,而是分支间环境差异没被显式声明——.vscode/settings.json 没提交、node_modules 没重装、工作区没点信任、语言模式被手误切错。这些点全在路径上,但每一步都得人眼确认,没法靠“同步”自动兜底。











