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 项目。
1.修正会员卡升级会员级别的判定方式2.修正了订单换货状态用户管理中心订单不显示的问题3.完善后台积分设置数据格式验证方式4.优化前台分页程序5.解决综合模板找回密码提示错误问题6.优化商品支付模块程序7.重写优惠卷代码8.优惠卷使用方式改为1卡1号的方式9.优惠卷支持打印功能10.重新支付模块,所有支付方式支持自动对账11.去掉规格库存显示12.修正部分功能商品价格显示4个0的问题13.全新的支
- 检查已启用的扩展,停用非主力格式化器(比如只留
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 的问题,而是格式化器没装、没配对、或者被另一个同类型工具悄悄拦截了。









