Format Document With…列表为空或变灰说明格式化插件未注册进语言服务链,主因是插件未激活、语言ID不匹配(如Vue文件用vue-html而非vue)或settings.json中未显式绑定对应语言块。

Format Document With… 列表为空或变灰
这说明 VS Code 根本没把你的格式化插件(比如 esbenp.prettier-vscode)注册进语言服务链。不是插件没装,而是它没“报到”。
- 按
Ctrl+Shift+P→ 输入Format Document With…,看列表里有没有目标插件;若空着,大概率是插件未激活,或语言 ID 不匹配(例如 Vue 文件用的是vue-html而非旧版vue) - 打开开发者工具(
Help → Toggle Developer Tools),切到Console标签页,再触发一次格式化——如果出现command 'editor.action.formatDocument' not found,说明格式化器根本没注册成功 - 某些新版插件(如
Volar 2.x)已弃用vue语言 ID,需在settings.json中显式绑定:"[vue-html]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }
editor.formatOnSave 开了但完全没反应
开关开着 ≠ 真正在工作。VS Code 的格式化触发链非常脆弱,任意一环断掉都会静默失效。
- 检查是否被工作区配置覆盖:打开项目根目录下的
.vscode/settings.json,确认里面没有写"[javascript]": { "editor.formatOnSave": false }这类语句 - 右下角语言模式必须正确(比如显示
TypeScript React,而不是Plain Text或JSONC);点它手动切换,别信自动识别 - 多个插件共存时,
editor.defaultFormatter可能被后加载的插件覆盖。例如dbaeumer.vscode-eslint启用后,会悄悄接管 JS/TS 文件,除非你明确把它设为默认值
保存后格式化了两次,缩进错乱、引号翻转
这不是 bug,是多个格式化器在抢着干活。VS Code 不会仲裁,谁最后注册、谁的配置优先级高,谁就执行。
- 典型冲突组合:
Prettier+ESLint+XML Tools;尤其当 ESLint 插件开启了eslint.format.enable,它就会强制用自己格式化 JS/TS,而 Prettier 规则全被忽略 - Python 项目里混用
esbenp.prettier-vscode很危险——它默认监听.py文件(尤其有.prettierrc时),会把 Python 缩进改成 JS 风格,直接破坏语法 - 临时验证法:终端运行
code --disable-extensions启动干净环境,再逐一启用插件,观察哪次开始出现双格式化
插件明明启用却报 “no formatter installed”
这个错误信息极具误导性。它不表示插件缺失,而是 VS Code 没找到能处理当前语言的格式化器实例。
- 先查插件是否真被加载:打开开发者工具 →
Console,过滤activate或插件 ID(如esbenp.prettier-vscode),找failed to activate报错 - 某些插件(如
ms-python.python)和ms-python.pylance共存时会争抢语言服务,导致其中一个静默退出;禁用前者、只留后者是最快解法 - 网络或版本不匹配也会导致插件“假启用”:本地 VS Code 是
1.102.3,而插件package.json里写的是"engines": { "vscode": "^1.90.0" },它会被自动禁用——此时要点插件右下角⋯ → Install Another Version…换兼容版
格式化失效最常卡在“语言 ID 绑定”和“插件加载时序”这两个看不见的环节。手动检查 Format Document With… 列表、开发者工具 Console 报错、以及 settings.json 中带方括号的语言块配置,比重装插件快十倍。











