VS Code HTML格式化失效主因是未安装/启用正确扩展、缺少prettier-plugin-html配置、或语言模式错误；需装Prettier/beautify扩展，设html.format.enable为true，指定默认格式化器，并确保文件关联HTML模式。
HTML 格式化快捷键没反应，先确认是不是用了错误的格式化器
VS Code 默认不自带 HTML 格式化能力，它依赖扩展。如果你按 Shift+Alt+F 或右键“格式化文档”没效果，大概率是没装或没启用正确的格式化扩展。
常见错误现象：右下角状态栏显示“No formatter installed for 'html'”，或者点了格式化后页面完全没变化。
实操建议：
- 打开扩展市场（Ctrl+Shift+X），搜
esbenp.prettier-vscode或beautify，装一个并重载窗口 - 装完后，右键 HTML 文件 → “格式化文档”，看是否弹出“选择默认格式化程序”提示；选
Prettier或JS-Beautify - 如果已装但没弹提示，手动设置：打开设置（Ctrl+,），搜
html.format.enable，确保它是true；再搜editor.defaultFormatter，在html语言关联里指定为esbenp.prettier-vscode
prettier 对 HTML 的支持有限，prettier.config.js 里要显式开启
Prettier 默认只处理 JS/TS/JSON，HTML 需要额外配置才能生效，否则即使装了插件，格式化也会静默失败。
常见错误现象：“格式化文档”执行成功（无报错），但缩进、换行、属性排序全没变。
实操建议：
- 项目根目录加
prettier.config.js，内容至少包含：module.exports = {<br> htmlWhitespaceSensitivity: 'ignore',<br> // 必须加上这行，否则 prettier 不识别 .html 文件<br> plugins: ['prettier-plugin-html']<br>}; - 运行
npm install --save-dev prettier-plugin-html（注意不是prettier本体） - 验证方式：在
.html文件里写一行紧凑代码，比如<div><span>text</span></div>，然后格式化——正常应自动换行缩进
vscode 设置里关掉了格式化开关，或者被其他扩展劫持
有时候格式化“看起来无效”，其实是被某个设置或冲突扩展拦截了，不是插件没装好。
常见错误现象：JS 文件能格式化，HTML 就不行；或者保存时自动格式化失效，但手动格式化又可以。
实操建议：
- 检查
editor.formatOnSave是否为true；再单独查[html].editor.formatOnSave—— 这个语言专属设置优先级更高，可能被设成了false - 禁用所有非必要扩展（尤其是旧版
html-snippets、auto-rename-tag等），重启 VS Code 后逐个启用，观察何时格式化失效 - 打开命令面板（Ctrl+Shift+P），运行
Developer: Toggle Developer Tools，切到 Console 标签页，点一次格式化，看有没有类似Failed to format document或formatter not found的报错
文件关联错了语言模式，.html 文件被当成 plain text 处理
VS Code 左下角语言模式显示为 Plain Text 或 PHP，会导致所有 HTML 相关功能（包括格式化）直接跳过。
常见错误现象：右下角语言标识不是 HTML，格式化菜单灰掉，或快捷键完全无响应。
实操建议：
- 点击左下角语言模式区域（如显示
Plain Text），在弹出框顶部搜索html，选HTML（不是HTML (EJS)或HTML (Ruby)） - 想永久修复：打开设置，搜
files.associations，添加"*.html": "html"（注意引号和冒号格式） - 如果项目里混用模板（如
.vue或.njk），别全局覆盖，改用工作区设置或.vscode/settings.json按文件夹配置
立即学习“前端免费学习笔记（深入）”；
HTML 格式化失效很少是单一原因，通常卡在“没装对插件 + 配置没开 + 语言模式不对”三者之一。最常被忽略的是 prettier-plugin-html 这个独立依赖，以及 [html].editor.formatOnSave 这个隐藏开关。
