VSCode保存Python文件不自动排版，90%因editor.formatOnSave未启用或未为[python]指定defaultFormatter；需检查JSON配置中该开关是否为true、语言专属设置是否正确绑定ms-python.black-formatter，并确认右下角语言模式为Python而非Plain Text。
VSCode 保存 Python 文件不自动排版，90% 是因为 editor.formatOnSave 没开，或没给 [python] 语言指定 editor.defaultFormatter —— 不是插件没装，而是 VSCode 根本不知道该用谁来格式化。
检查 editor.formatOnSave 是否真正启用
这个开关默认是 false，哪怕你装了十个格式化插件，它也安静如鸡。别只信 UI 界面勾选了就完事，得看实际生效位置：
- 按
Ctrl + ,（Windows/Linux）或Cmd + ,（macOS），搜format on save，确认「Editor: Format On Save」已勾选 - 打开命令面板（
Ctrl + Shift + P），运行Preferences: Open Settings (JSON)，检查是否存在"editor.formatOnSave": true - 重点查项目根目录下的
.vscode/settings.json：如果里面有"editor.formatOnSave": false或"[python]": { "editor.formatOnSave": false }，它会直接覆盖用户设置
确认 [python] 语言绑定了正确的格式化器
VSCode 不会把 Black 当成 Python 的默认工具，除非你明说。右下角状态栏显示 Python ≠ 自动启用 Black；它只是语言模式，不是执行指令。
- 在
settings.json中必须写成语言专属形式："[python]": { "editor.defaultFormatter": "ms-python.black-formatter" } - 不能写全局形式：
"editor.defaultFormatter": "ms-python.black-formatter"——这会让.go、.json文件报错或静默失败 - 手动触发一下：
Shift + Alt + F（Windows/Linux）或Shift + Option + F（macOS），看是否弹出格式化选项；若列表为空，说明扩展未启用或不支持当前语言模式 - 注意：
ms-python.python扩展 ≠ 格式化器，它只提供语言服务；格式化需额外安装ms-python.black-formatter或配置python.formatting.provider
验证文件是否被识别为 Python 语言模式
VSCode 的格式化逻辑严格依赖右下角显示的语言标识。哪怕文件后缀是 .py，如果状态栏显示的是 Plain Text 或 JavaScript，所有 Python 相关格式化配置都会被跳过。
立即学习“Python免费学习笔记（深入）”；
- 点击右下角语言模式（如
Python），确认不是Plain Text；若是，选「Configure Language Specific Settings…」→ 设为python - 临时测试：新建一个空文件 → 保存为
test.py→ 看右下角是否自动变成Python；若没变，说明文件关联损坏，可手动设files.associations - 某些项目中，
.py文件被eslint或其他插件劫持语言模式，导致格式化器加载失败
最容易被忽略的点是：多个配置层级（用户 / 工作区 / 语言专属）之间存在覆盖关系，且错误不会报红提示，只会静默失效。建议排查时先删掉项目级 .vscode/settings.json 中所有格式化相关字段，用最简配置验证基础链路是否通，再逐步加回定制项。
