VS Code格式化失效需三步排查：先安装对应语言的格式化扩展（如esbenp.prettier-vscode），再在settings.json中为每种语言显式绑定默认格式化器，最后确保配置文件（如prettier.config.js）语法正确且含必要插件。
格式化命令没反应：先确认有没有可用的格式化器
按 Shift+Alt+F 没反应，或弹出 “There is no formatter for 'javascript'-files installed.”，说明 VS Code 根本没找到能干活的扩展。这不是配置问题，是前置条件缺失。
- 打开命令面板（
Ctrl+Shift+P），输入Format Document With…，看下拉列表里有没有选项 - 如果列表为空，立刻安装对应语言的格式化扩展：JavaScript/TypeScript/JSX 用
esbenp.prettier-vscode；Vue 项目建议额外加octref.vetur或johnsoncodehk.volar；HTML 文件若用 Prettier，必须装prettier-plugin-html - 装完别忘了重启 VS Code 或重开文件——有些插件不 reload 就不注册 Provider
右键“Format Document With…”里有 Prettier 却不生效：检查默认格式化器绑定
列表里能看到 esbenp.prettier-vscode，但点它没反应，或点了之后又退回到内置格式化器（比如 vscode.typescript-language-features），说明绑定失败或被降级了。
- 右键 →
Configure Default Formatter…→ 选当前文件类型（如javascript），再选esbenp.prettier-vscode - 更稳妥的做法是直接改
settings.json，为每种语言显式声明："[javascript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }"[typescriptreact]": { "editor.defaultFormatter": "esbenp.prettier-vscode" } - 注意拼写：必须是
esbenp.prettier-vscode，不是prettier、prettier-vscode或其他别名 - HTML 文件容易漏掉：它不走标准 language ID，得单独加
"[html]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }，且项目根目录必须有prettier.config.js并含plugins: ['prettier-plugin-html']
保存时自动格式化开了却没触发：排查配置覆盖和语言模式
"editor.formatOnSave": true 看似开着，但可能被工作区设置、语言专属设置或状态栏语言模式悄悄关掉。
- 按
Ctrl+Shift+P→Preferences: Open Workspace Settings (JSON)，搜formatOnSave，确认没出现"[javascript]": { "editor.formatOnSave": false }这类显式关闭项 - 右下角状态栏看当前语言模式：如果是
Plain Text而不是JavaScript或HTML，formatOnSave直接不启动——点击语言标识，选Configure File Association for .js手动绑定 - 不要只在全局设
formatOnSave，必须配合语言块，否则对 JS/TS/HTML 等无效
格式化结果不符合预期：配置文件语法错误导致静默退出
Prettier 遇到 .prettierrc 解析失败时，不会报错，而是彻底放弃加载规则，退回到“什么都不做”——你看到的“没变化”，其实是它连规则都没读进去。
- 把
.prettierrc（JSON 格式）换成prettier.config.js，后者支持注释、变量、函数逻辑，容错性高 - 运行
npx prettier --debug-check index.js，它会明确告诉你哪一行、哪个 key 出错（比如trailingcomma拼错，或用了单引号） - HTML 文件必须加
htmlWhitespaceSensitivity: 'ignore'，否则 Prettier 默认跳过处理 - React 项目记得配
"[javascriptreact]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }，别只配[javascript]
