VSCode保存时自动格式化需语言服务、格式化工具和配置项三者同时就位；缺一不可，否则Ctrl+S仅保存不格式化。
VSCode 保存时自动格式化不是开个开关就能一劳永逸的事，它依赖三个关键环节同时就位：语言服务支持、格式化工具安装、以及正确的配置项启用。缺一个，Ctrl+S 就只是保存，不会触发任何格式化。
确认当前文件类型有可用的格式化提供者
VSCode 不自带格式化逻辑，它只调用已安装的格式化扩展（比如 esbenp.prettier-vscode、ms-python.python 或 redhat.vscode-yaml）。如果保存没反应，先看右下角状态栏的语言模式（如 “Python”、“JavaScript React”），再按 Ctrl+Shift+P 输入 Format Document With...，看是否有选项可选。没有，说明该语言缺少对应扩展或扩展未激活。
- 常见遗漏：JS/TS 项目没装 Prettier 扩展，或装了但没在工作区启用；YAML 文件没装 YAML 支持插件
- 注意：某些语言（如 Go）需要
gopls启动成功后才提供格式化能力，可查看输出面板中Go日志确认 - 临时验证方式：手动执行一次
Format Document（Shift+Alt+F），成功了说明工具就绪，问题出在保存触发配置上
开启保存时格式化的全局或工作区配置
仅靠扩展还不够，必须显式开启保存触发行为。VSCode 提供两个层级的开关："editor.formatOnSave"（控制是否启用）和 "editor.formatOnSaveMode"（控制格式化范围）。两者都需正确设置。
-
"editor.formatOnSave": true是基础开关，建议设为true；若只想对特定语言启用，改用语言专属设置，例如："[javascript]": { "editor.formatOnSave": true } -
"editor.formatOnSaveMode"默认是"file"（整文件格式化），但某些场景（如大 JSON 文件）可能想只格式化修改区域，可设为"modifications"；不过多数 LSP 格式化器不支持该模式，设了也无效 - 避免冲突：如果同时启用了
"editor.formatOnType"或"editor.formatOnPaste"，它们和保存格式化互不影响，但可能造成光标跳动等干扰体验
处理多格式化器共存时的优先级问题
当一个文件类型被多个扩展支持（比如 JS 同时装了 ESLint 和 Prettier 插件），VSCode 可能无法自动决定用谁，导致保存时无响应或格式错乱。这时必须明确指定默认格式化工具。
- 右键编辑器空白处 →
Format Document With...→ 选中想要的格式化器 → 点击Configure Default Formatter...→ 选择对应扩展 - 该操作会在当前工作区的
.vscode/settings.json中写入类似："javascript.format.default": "esbenp.prettier-vscode"
- 注意：部分扩展（如 Prettier）会要求你额外配置
"prettier.requireConfig"或检查项目根目录是否存在.prettierrc，否则即使设为默认也可能静默失败 - 排查技巧：打开命令面板 →
Developer: Toggle Developer Tools→ 切到 Console 标签，保存文件，看是否有Failed to format类错误
真正卡住人的往往不是“怎么开”，而是“开了为什么没反应”——这时候要一层层查：语言服务有没有、格式化扩展装没装对、默认格式化器有没有指定、项目配置文件是否存在且合法。尤其要注意 Prettier 和 ESLint 的协作配置，它们之间容易互相覆盖规则，导致保存后代码反而被“格式化坏”。
