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 图标是否变灰，是最快判断方式。
