VSCode“保存时格式化”需四步协同生效：开启editor.formatOnSave、指定语言默认格式化器、确认语言模式正确、验证手动格式化可用；任一环节缺失均导致静默失效。
VSCode 的“保存时格式化”不是开箱即用的功能，它需要多个环节协同工作——设置开启、插件就位、语言匹配、配置无冲突。只要其中一环断开，保存就不会触发格式化，而且通常不报错，只“静默失效”。
检查 editor.formatOnSave 是否真正启用
这是最基础也最容易被忽略的一环。VSCode 默认是关闭该功能的。
- 打开设置（Ctrl + , 或 Cmd + ,），搜索 format on save，确认 Editor: Format On Save 已勾选
- 更可靠的方式是直接编辑 settings.json，确保含这一行：
"editor.formatOnSave": true - 注意作用域：用户设置、工作区设置、文件夹设置有优先级，工作区的
.vscode/settings.json会覆盖用户设置，建议检查当前项目是否意外禁用了它
确认默认格式化程序已指定且可用
即使开启了 formatOnSave，VSCode 也不知道该调谁来格式化——必须明确告诉它用哪个插件。
- 在
settings.json中添加对应语言的默认格式化器，例如：
"[javascript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" } - 右键编辑器空白处 → “格式化文档时使用” → 查看是否有可用选项；若显示“未找到格式化程序”，说明插件未安装、未启用，或语言模式识别错误
- 对 Go/Python/Rust 等语言，还需确保对应语言服务器（如
gopls、pylsp）已安装并正常运行
排查语言模式与扩展冲突
VSCode 按“语言模式”（Language Mode）决定启用哪些功能。如果文件被识别成 Plain Text 而不是 JavaScript，Prettier 就根本不会被调用。
- 查看窗口右下角状态栏，确认当前文件的语言模式正确（如 JavaScript、Vue、XML）；点它可手动切换
- 若常见后缀（如
.vue、.astro）未被识别，需在settings.json中补全关联：
"files.associations": { "*.vue": "vue" } - 临时禁用其他格式化类插件（如 Beautify、ESLint（未配置协同时）、Auto Rename Tag），避免抢注格式化提供者导致冲突
验证格式化能否手动触发
这是快速定位问题的关键动作——如果手动格式化都失败，说明底层链路已中断。
- 按快捷键 Shift + Alt + F（Windows/Linux）或 Shift + Option + F（macOS）
- 或右键 → “格式化文档”，看是否弹出“找不到格式化程序”提示
- 若手动也不行：重点查插件是否启用、语言模式是否正确、
defaultFormatter配置是否拼写准确（比如esbenp.prettier-vscode不能少字母或多空格） - 若手动可以但保存不行：大概率是
formatOnSave未生效，或被工作区设置覆盖，或存在editor.formatOnSaveMode限制（如设为"modifications"但文件无修改）
基本上就这些。不需要重装、不用改系统环境，90% 的问题都能靠这四步定位出来。关键不是“有没有装插件”，而是“VSCode 当前是否知道该用谁、对什么、怎么用”。
