VSCode格式化失效主因是缺少对应语言的formatter扩展，需安装并配置如Pylance、Prettier等；检查“Format Document With”列表、启用editor.formatOnSave、指定默认formatter、确认文件关联与配置文件有效性。

格式化快捷键没反应，先确认是否装了对应语言的格式化工具

VSCode 本身不内置语言格式化逻辑，Shift+Alt+F 或右键「格式化文档」失效，大概率是因为缺少该语言的 formatter 扩展。比如写 Python 却没装 Pylance 或 Black Formatter，写 TypeScript 却没装 ESLint 或 Prettier，VSCode 就会静默跳过格式化。

检查方法：Ctrl+Shift+P → 输入「Format Document With」→ 看下拉列表里有没有可用的 formatter。如果为空或只有「Configure Default Formatter…」，说明缺扩展。

• Python 常用：安装 ms-python.python（含 autopep8 / black / yapf 支持），再在设置里指定 python.formatting.provider
• TypeScript/JS：装 esbenp.prettier-vscode 后，确保工作区有 .prettierrc 或 package.json 中含 prettier 配置
• 注意：某些 formatter（如 black）需本地已通过 pip install black 安装，否则扩展会报「command not found」但不提示错误

自动保存后没格式化，重点查这三个设置项

「文件 → 自动保存」打开只是第一步，真正触发格式化的关键是 editor.formatOnSave 是否启用，且不能被更细粒度的设置覆盖。

打开设置（Ctrl+,），搜索以下三项，逐个确认：

• editor.formatOnSave：必须为 true
• editor.formatOnSaveMode：默认 file 即可；若设为 modifications，只格式化修改过的行，容易误以为“没生效”
• [javascript].formatOnSave 这类语言专属设置：如果单独关掉了某语言的格式化，全局设置会被忽略

推荐直接在 settings.json 里显式声明，避免 GUI 设置被继承层级干扰：

{
  "editor.formatOnSave": true,
  "editor.formatOnSaveMode": "file",
  "[typescript]": {
    "editor.formatOnSave": true
  },
  "[python]": {
    "editor.formatOnSave": true
  }
}

格式化结果和预期不符，优先排查默认 formatter 冲突

多个 formatter 扩展共存时（比如同时装了 Prettier 和 ESLint），VSCode 可能选错默认工具，导致缩进、分号、引号风格混乱。

解决路径很直接：

• 右键编辑器 → 「Format Document With…」→ 选「Configure Default Formatter…」→ 为当前语言手动指定一个（如 esbenp.prettier-vscode）
• 如果用了 ESLint，确保 eslint.format.enable 为 true，且项目根目录有 .eslintrc.js 或 eslintConfig 字段
• 禁用冲突扩展：比如不需要 ESLint 格式化功能，就关掉 dbaeumer.vscode-eslint 的格式化能力（保留 lint 提示）

常见症状：prettier 要求单引号，但保存后还是双引号 → 很可能是 eslint 在背后按自己的规则重写了

保存时卡顿或部分文件不触发，留意文件关联与大文件限制

VSCode 对超大文件（默认 > 50MB）或未识别语言的文件会跳过格式化，且不会报错。

• 检查右下角语言模式是否正确：比如 .ts 文件显示为「Plain Text」，editor.formatOnSave 就不会启动
• 大文件：在 settings.json 中调高限制："editor.largeFileOptimizations": false（慎用，可能卡死）
• 工作区配置覆盖用户配置：如果项目根目录有 .vscode/settings.json，它会优先生效，记得检查里面有没有 "editor.formatOnSave": false

最隐蔽的坑：某些 formatter（如 prettier）依赖 package.json 中的 prettier 字段或 .prettierrc 文件。文件存在但路径不对（比如放在子目录）、权限不足、或 JSON 语法错误，都会导致格式化静默失败 —— 此时看 VSCode 右下角状态栏的 formatter 图标是否变灰，是最快判断方式。