开启“保存时自动格式化”需先启用editor.formatOnSave，再为对应语言指定默认格式化器（如Python设ms-python.black-formatter），并检查项目级配置（如.vscode/settings.json或pyproject.toml）是否覆盖了设置。
怎么开启“保存时自动格式化”这个开关
VSCode 默认是关着的，装了 Prettier 或 Black 也没用——你得亲手打开它。
- 快捷键
Ctrl + ,（Windows/Linux）或Cmd + ,（macOS）进设置，搜format on save，勾选Editor: Format On Save - 或者直接改
settings.json，加一行："editor.formatOnSave": true - 注意：这只是个“触发器”，不是“执行者”——它只负责喊一声“该格式化了”，但派谁去干，还得你指定
为什么保存后没反应？常见原因和检查点
开了开关却没效果，90% 是因为 VSCode 不知道该叫谁来干活，或者叫错了人。
- 右下角状态栏看当前文件的格式化器显示，如果是
None，说明没匹配到可用工具 - 右键 →
Format Document With...，看看列表里有没有你装的扩展（比如esbenp.prettier-vscode或ms-python.black-formatter） - 如果列表为空，回去确认扩展是否已启用，且支持当前语言（例如
black-formatter对.py有效，对.js就无效） - 多个格式化扩展共存时（比如同时装了 Prettier 和 ESLint），VSCode 可能卡在选择环节，导致静默失败
怎么为 Python/JavaScript 等语言指定默认格式化器
不同语言要用不同工具，而且必须显式绑定，否则 VSCode 会拒绝执行格式化。
- 在设置里搜
default formatter，点开对应语言（如[python]）的下拉菜单，选你信任的那个扩展 - 更稳妥的方式是写进
settings.json：{ "[python]": { "editor.defaultFormatter": "ms-python.black-formatter" }, "[javascript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" } } - 别把
eslint当主力格式化器设成默认——它本质是检查器；若真要用 ESLint 格式化，得额外开"eslint.format.enable": true，且建议配合eslint-config-prettier关掉冲突规则
项目级配置为什么比用户设置更重要
团队协作时，你本地的全局设置很可能被项目根目录下的 .vscode/settings.json 覆盖，这是设计使然，不是 bug。
- 检查项目里有没有
.vscode/settings.json，里面可能写了"editor.formatOnSave": false—— 这会直接关掉你的自动格式化 - Python 项目若有
pyproject.toml，其中的[tool.black]配置会被black-formatter自动读取，VSCode 不接管参数，只调用 - JS/TS 项目若有
.prettierrc，Prettier 扩展也会优先读它，而不是你 settings 里的零散选项
