Output面板才是真实日志源,按Ctrl+Shift+U打开后在右上角下拉菜单选择Prettier、ESLint等扩展,可查看Failed to load config、No configuration file found等原始错误堆栈。

Format Document 报错时,Output 面板才是真实信源
VSCode 的 Problems 面板和弹窗提示(比如 There is no formatter for 'javascript'-files installed.)只是表层信号,真正能定位“为什么没格式化”的日志全在 Output 面板里。它按扩展分通道输出原始错误、解析失败堆栈、服务启动状态,比 Console 更贴近格式化器实际运行过程。
操作路径:Ctrl+Shift+U(Windows/Linux)或 Cmd+Shift+U(macOS)→ 右上角下拉菜单选择对应扩展名,例如:
-
Prettier:看是否报Failed to load config或No configuration file found -
ESLint:留意ESLint server is not running或Cannot find module 'eslint' -
Volar:搜索formatting disabled或languageId mismatch -
XML Tools:常见Missing XML declaration或BOM encoding error
Console 里查 command not found 类错误最直接
当右键菜单里的 Format Document 置灰,或快捷键完全无响应,大概率是格式化命令根本没注册进 VSCode。这时打开开发者工具(Ctrl+Shift+P → Developer: Toggle Developer Tools),切到 Console 标签页,再触发一次格式化——如果出现 command 'editor.action.formatDocument' not found 或类似 command 'esbenp.prettier-vscode.format' not found,说明插件未激活、被禁用,或新版插件改名/弃用旧 command ID。
常见对应关系:
-
Volar 2.x废弃了volar.format,改用volar.vue-format,旧配置会失效 -
Red Hat XML升级后默认关闭xml.format.enable,需手动设为true -
ESLint 插件若开启eslint.format.enable,但没装eslint包,控制台会报spawn eslint ENOENT
语言模式错配导致“静默跳过”,右下角必须人工核对
VSCode 不看文件后缀,只认右下角显示的语言模式(Language Mode)。一旦错配,格式化器连启动都不会启动——既不报错,也不执行,看起来就是“无效”。比如:
- .vue 文件显示为
Plain Text→ Prettier / Volar 都不会介入 - .jsonc 文件显示为
JSON→ 缺少注释支持,格式化时直接抛Unexpected token / - .api.ts 文件没映射 → 默认当
Plain Text,prettier直接跳过
修复方式:
- 点击右下角语言标识 → 选正确类型(如
Vue、JSONC、TypeScript) - 对自定义后缀,在
settings.json加"files.associations": { "*.api.ts": "typescript" } - 确认
"[vue]": { "editor.defaultFormatter": "..." }这类语言块已更新为新版 ID(如[vue-html])
格式化结果异常?别急着调规则,先看输出里有没有 parse error
缩进错乱、引号不统一、空行消失,表面像规则问题,实则常是解析阶段就崩了。比如 Prettier 报 Unexpected tab character,不是它不想修,是它拒绝处理含 Tab 的文件(因 prettier.useTabs 为 false);又如 XML Tools 报 Unexpected end of input,大概率是文件开头有 BOM 或漏了 。
这类错误几乎都藏在 Output 面板对应通道的首几行,且往往带 ParseError、SyntaxError、Unexpected 关键字。只要看到它们,优先修正文件可解析性,而不是去改 .prettierrc。
特别注意:
-
UTF-8 with BOM是 JSON/XML/.env 文件的隐形杀手,务必存为UTF-8 without BOM -
prettier.requireConfig设为true但项目没.prettierrc,Prettier 会静默退出,Output 里只有一行Skipping file — no config found -
Volar中volar.format.enable默认false,不手动开,和区域根本不会走 Prettier











