VSCode保存时自动格式化未生效，主因是未启用editor.formatOnSave、语言模式错误、缺少对应格式化扩展或被工作区配置覆盖；需检查右下角语言标识、安装并指定默认格式化器（如Prettier）、确认配置层级及输出面板日志。
VSCode 的代码格式化不会自动发生，除非你明确配置了触发条件或主动调用——这是绝大多数人卡住的第一步。
保存时自动格式化为什么没生效
常见现象是勾选了 editor.formatOnSave 却毫无反应，根本原因通常是：当前文件没有绑定语言模式，或未安装对应语言的格式化扩展。
- 检查右下角状态栏语言标识（如
JavaScript、Python），点击它手动选择正确语言模式 - 确认已安装对应扩展：比如
esbenp.prettier-vscode（JS/TS）、ms-python.python（含 Black 支持）、ms-vscode.vscode-typescript-next（TS 内置） -
editor.formatOnSave是语言级开关，若设置在用户层级但项目里有.vscode/settings.json，后者可能覆盖前者 - 某些扩展（如 ESLint）需额外开启
"editor.codeActionsOnSave": { "source.fixAll": true }才能修复格式+逻辑问题
Ctrl+K Ctrl+F 格式化选中代码块失效的典型场景
这个组合键只对「已选中文本」起作用，且依赖语言服务返回有效格式化结果；不是所有语言都支持区域格式化。
- 选中后按
Ctrl+K，松手再按Ctrl+F—— 快捷键必须分两步，连按无效 - Vue 单文件组件中，若光标落在
<style>区域但语言模式仍是Vue，Prettier 可能不响应，需切换为CSS模式再试 - TypeScript 文件若含语法错误（如未闭合括号），部分格式化器会直接跳过，此时先修复报错再格式化
- 使用
editor.formatOnType时，输入}或;后自动格式化仅在支持该特性的扩展中可用（Prettier 默认关闭，ESLint + TypeScript 支持较好）
Shift+Alt+F 全文件格式化失败的排查点
快捷键无响应或格式化结果异常，大概率是格式化器本身拒绝处理，而非 VSCode 问题。
- 检查是否设置了
editor.defaultFormatter，例如："[typescript]": { "editor.defaultFormatter": "vscode.typescript-language-features" } - 若用了 Prettier，确认项目根目录存在
.prettierrc或prettier.config.js，否则它可能回退到默认规则导致意外换行 - 某些格式化器（如 Black）不支持
editor.formatOnType，也不响应Ctrl+K Ctrl+F，只认Shift+Alt+F和editor.formatOnSave - 大文件（>1MB）可能被格式化器主动跳过，VSCode 日志里会显示
Skipping formatting: file too large
多语言混编项目中的格式化冲突
一个 .vue 或 .astro 文件里同时写 JS、CSS、HTML，不同区块由不同格式化器接管，容易互相覆盖或漏掉。
- Vetur 已停更，推荐改用
vue-vscode-extension或直接靠esbenp.prettier-vscode+unifiedjs生态统一处理 - 在
.prettierrc中用overrides显式指定不同文件类型规则，避免 HTML 区块被 JS 规则误伤 - 禁用某语言的自动格式化：在工作区设置中加
"[json]": { "editor.formatOnSave": false }，防止 JSON 配置被重排破坏可读性 - 编辑器底层按语言 ID 路由格式化请求，
languageId错配（如把mdx当作markdown）会导致格式化器不加载
真正麻烦的从来不是快捷键记不住，而是格式化器在后台静默失败——打开 VSCode 底部状态栏右侧的「输出」面板，切换到「Log (Extension Host)」，保存文件时看有没有 Failed to format 类日志，这才是定位问题的起点。
