VSCode默认不启用自动格式化，需手动开启“保存时格式化”并为每种语言指定唯一格式化工具（如Python用Black、JS用Prettier），避免多扩展冲突，且项目级配置优先于用户设置。
VSCode 本身不自带代码格式化逻辑，所有自动格式化行为都依赖扩展和配置组合。开箱即用的“保存时自动格式化”默认是关闭的，必须手动开启并指定格式化工具。
启用保存时自动格式化
这是最常用也最容易被忽略的开关。VSCode 默认不格式化，即使你装了 Prettier 或 Black，不打开这个选项也不会生效。
- 打开设置（
Ctrl+,或Cmd+,），搜索format on save - 勾选
Editor: Format On Save - 注意：该设置是全局的，但可被工作区或语言级设置覆盖
为特定语言指定默认格式化工具
不同语言需要不同的格式化器（比如 Python 用 black，JavaScript 用 prettier），VSCode 必须知道“用谁来格式化”。否则会报错 No formatter installed for 'javascript'。
- 安装对应语言的格式化扩展（如
esbenp.prettier-vscode、ms-python.black-formatter） - 在设置中搜索
default formatter，找到Editor: Default Formatter - 点击下拉菜单，为每种语言单独选择——例如对
python选ms-python.black-formatter，对javascript选esbenp.prettier-vscode - 也可直接编辑
settings.json：
{
"[python]": {
"editor.defaultFormatter": "ms-python.black-formatter"
},
"[javascript]": {
"editor.defaultFormatter": "esbenp.prettier-vscode"
}
}
避免格式化冲突：禁用其他格式化器
多个格式化扩展同时启用，尤其当它们都监听同一语言时，会导致保存时反复格式化、光标跳动、甚至格式错乱。常见于同时装了 prettier 和 eslint 的 JS 项目。
- 检查已启用的扩展，停用非主力格式化器（比如只留
prettier，关掉js-beautify） - 确认
eslint扩展未开启eslint.format.enable（它不是纯格式化器，混用易出问题） - 若用 ESLint 做代码检查，建议仅让它报告问题，格式化交给 Prettier 单独完成
项目级配置优先于用户级设置
VSCode 会按顺序读取：语言级设置 → 工作区 .vscode/settings.json → 用户 settings.json。这意味着团队项目里，你本地的全局设置可能被项目配置覆盖。
- 检查项目根目录下是否有
.vscode/settings.json，里面可能有"editor.formatOnSave": false - Python 项目常带
pyproject.toml，其中[tool.black]配置会影响black-formatter行为，VSCode 只是调用它，不接管参数 - JS/TS 项目若有
.prettierrc，VSCode 的 Prettier 扩展会自动读取，无需在设置里重复写规则
真正容易卡住的点不在“怎么开”，而在“开了之后谁来执行、执行谁、有没有别的东西在抢着执行”。格式化失败往往不是 VSCode 的问题，而是格式化器没装、没配对、或者被另一个同类型工具悄悄拦截了。
