保存时自动格式化未生效，需确认已安装并设为默认的格式化器，开启editor.formatOnSave，配置项目级格式化文件，并检查超时、冲突设置及格式化范围模式。
保存时自动格式化没生效？先确认格式化器已安装
VSCode 本身不自带语言专属的代码格式化逻辑，保存时自动格式化 功能依赖你为当前文件类型安装并启用对应的格式化扩展。比如：Python 需要 ms-python.python 或 ms-python.pylint（实际格式化由 autopep8/black/yapf 提供）；JavaScript/TypeScript 默认用内置的 typescript-language-features，但若想用 Prettier，必须手动装 esbenp.prettier-vscode。
常见错误现象：点了保存，代码纹丝不动，控制台也无报错——大概率是没装对格式化器，或装了但没设为默认。
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），运行Format Document With...，看列表里有没有可用选项；没有则说明缺失格式化器 - 若有多个选项，选中后勾选
Configure Default Formatter for 'xxx'，把对应语言的默认格式化器固定下来 - 某些格式化器（如
prettier）需额外配置prettier.config.js或.prettierrc文件才能按预期工作，仅装扩展不够
核心设置项：editor.formatOnSave 必须为 true
editor.formatOnSave 是开关总闸，设为 false 或未定义，其他所有配置都无效。它支持全局、工作区、语言级三层覆盖，优先级：语言级 > 工作区 > 全局。
推荐在工作区根目录的 .vscode/settings.json 中显式声明，避免受用户全局设置干扰：
citySHOP是一款集CMS、网店、商品、系统，管理更加科学快速；全新Jquery前端引擎；智能缓存、图表化的数据分析，手机短信营销；各种礼包设置、搭配购买、关联等进一步加强用户体验；任何功能及设置都高度自定义；MVC架构模式，代码严禁、规范；商品推荐、促销、礼包、折扣、换购等多种设置模式；商品五级分类，可自由设置分类属性；商品展示页简介大方，清晰，图片自动放大，无需重开页面；商品评价、咨询分开
{
"editor.formatOnSave": true,
"editor.defaultFormatter": "esbenp.prettier-vscode",
"[javascript]": {
"editor.defaultFormatter": "esbenp.prettier-vscode"
},
"[typescript]": {
"editor.defaultFormatter": "esbenp.prettier-vscode"
}
}
- 不要只改 UI 设置界面里的勾选项，它可能写到用户
settings.json，导致团队协作时不同步 - 如果某语言（如
json）不需要格式化，可单独关掉："[json]": { "editor.formatOnSave": false } - 注意：某些格式化器（如
eslint的eslint.format）已废弃，新版应使用eslint.codeAction.onSave.fixAll配合editor.codeActionsOnSave
格式化卡住或报错？检查 editor.formatOnSaveTimeout 和冲突项
默认超时时间是 750 毫秒，大型文件或慢速格式化器（如某些 go fmt 封装、旧版 clang-format）容易触发超时，表现为保存后无反应、状态栏显示“正在格式化…”但一直不结束。
- 临时调高超时值：
"editor.formatOnSaveTimeout": 2000（单位毫秒） - 禁用可能冲突的设置：
editor.formatOnType和editor.formatOnPaste在部分场景下会与保存格式化抢资源，建议关掉 - 若用
Prettier + ESLint组合，避免同时开启editor.formatOnSave和editor.codeActionsOnSave的source.fixAll，否则会重复格式化甚至互相覆盖
保存时只格式化修改行？用 editor.formatOnSaveMode 控制范围
VSCode 1.84+ 引入了 editor.formatOnSaveMode，允许你指定格式化范围：file（全文件，默认）、modifications（仅修改过的行）。后者适合大文件协作、避免提交无关空格变更。
启用方式很简单，在 settings.json 中加一行：
"editor.formatOnSaveMode": "modifications"
- 该模式要求格式化器本身支持增量格式化（
Prettier1.19+、prettier-eslint等支持；black目前不支持） - 若开启后格式化失效，先查输出面板中
Log (Window)或Prettier频道是否有Range formatting is not supported类提示 - 注意：
modifications模式下，首次保存仍会格式化整文件，后续保存才限于改动区域
.prettierrc、pyproject.toml）三者对齐。最容易被忽略的是：你以为装了 Prettier 扩展就万事大吉，其实它根本不知道你项目里写了 semi: false，除非你把配置文件放在正确路径并确保扩展能读到。 
