VSCode格式化HTML失效主因是未为[html]语言显式指定editor.defaultFormatter为"esbenp.prettier-vscode"，且需禁用html.format.enable以避免内置格式器冲突；同时须确保文件语言模式为HTML、项目有.prettierrc、formatOnSave已启用。
VSCode 代码格式化失效，90% 是因为没正确指定 editor.defaultFormatter —— 不是插件没装，而是 VSCode 根本不知道该叫谁来干活。
为什么“装了 Prettier 却不格式化 HTML”
VSCode 默认不处理 HTML 文件的格式化逻辑，即使你装了 esbenp.prettier-vscode，它也不会主动接手，除非你明确告诉它：“HTML 文件归你管”。
常见错误现象：Right-click → Format Document 点击后无反应；状态栏显示 No formatter installed for 'html'；或格式化后属性没换行、缩进全乱。
实操建议：
• 打开设置（Ctrl+,），搜 editor.defaultFormatter，展开语言专属设置 → 点击 [html] → 输入 esbenp.prettier-vscode（必须完整 ID，不能写 prettier 或留空）
• 同时确保 html.format.enable 为 true（这是 VSCode 内置 HTML 格式化开关，和 Prettier 无关，但若关了会拦截所有 HTML 格式化请求）
• 如果用的是 Vue/Svelte 文件，还要单独配 [vue] 或 [svelte] 语言块，ID 一样填 esbenp.prettier-vscode
JavaScript/TypeScript/React 文件格式化失灵
JSX、TSX 文件属于独立语言模式（javascriptreact、typescriptreact），和纯 javascript 不通用。很多人只配了 [javascript]，结果 .tsx 文件完全不响应格式化。
常见错误现象：.js 文件能格式化，.tsx 却没变化；右键菜单里“Format Document With”列表为空；保存时自动格式化静默跳过。
实操建议：
• 在 .vscode/settings.json 中显式声明三组配置："[javascript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }"[javascriptreact]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }"[typescriptreact]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }
• 别依赖全局设置——工作区级（项目根目录 .vscode/settings.json）优先级最高，且团队协作更可靠
• 验证方式：打开任意 .tsx 文件，按 Ctrl+Shift+P → 输入 Format Document With → 看是否列出 Prettier；若没列，说明语言 ID 没对上
格式化快捷键 Shift+Alt+F 没反应？先查命令绑定和语言 ID
快捷键本身可能被覆盖、禁用，或者根本没绑定到当前语言的格式化命令上。
常见错误现象：按键后毫无反馈；开发者工具 Console 里出现 command 'editor.action.formatDocument' not found；Mac 上按 Shift+Option+F 却触发系统强制退出。
实操建议：
• 运行 Ctrl+Shift+P → Preferences: Open Keyboard Shortcuts (JSON)，检查有没有带减号的禁用项，例如：{"key":"shift+alt+f","command":"-editor.action.formatDocument"}（删掉整行）
• 按 Ctrl+Shift+P → Developer: Inspect Editor Tokens and Scopes，看右上角显示的 languageId 是什么（比如是 plaintext 或 typescriptreact），再核对 settings 里是否为该 ID 配了 editor.defaultFormatter
• 若文件后缀未被识别（如 .config.js 被当成 javascript，但实际要按 JSON 规则格式化），加 "files.associations": { "*.config.js": "json" } 到设置中
格式化“成功”但结果不对？检查插件与配置的执行优先级
格式化器运行成功 ≠ 结果符合预期。Prettier 可能跑完了，但被 ESLint 的 source.fixAll.eslint 覆盖了引号、分号等；或者 prettier.requireConfig 设为 true，而项目里没放 .prettierrc，导致它悄悄退场。
常见错误现象：保存后单引号变双引号；缩进从 2 空格变成 4；自动插入分号；或明明改了 prettier.tabWidth 却没生效。
实操建议：
• 关闭 ESLint 的自动修复格式动作："editor.codeActionsOnSave": { "source.fixAll.eslint": false }（让 Prettier 专注格式，ESLint 专注报错）
• 把核心规则写进项目级 prettier.config.js，而非仅靠 VSCode 设置，避免环境差异：module.exports = { tabWidth: 2, semi: false, singleQuote: true };
• 检查 prettier.requireConfig 是否为 false（开发阶段推荐设为 false，避免配置缺失导致静默失败）
• 注意：VSCode 的 editor.tabSize 是 fallback 值，只有当格式化器没指定 tabWidth 时才生效；别指望靠它统一 Prettier 行为
最容易被忽略的一点：语言 ID 必须精确匹配，大小写、连字符、react 后缀一个都不能错；editor.defaultFormatter 值必须用扩展的完整发布 ID，不是名字也不是包名。配错一个字符，VSCode 就当没这回事。
