VSCode无“切换分支时自动保存”功能，本质是提前保存避免Git拒绝切换；推荐files.autoSave设为onFocusChange，仅保存当前编辑器文件，需配合stash确保安全。
git checkout 或 git switch 时触发保存动作。所谓“切换分支时保存”，本质是**提前保存当前修改，避免被 Git 拒绝切换**，而不是 VSCode 主动响应分支变化。
下面直接说清楚怎么做、为什么这么设、以及最容易翻车的地方。
切换分支前必须手动或自动保存文件
Git 要求工作区干净（或至少没有冲突性修改）才能安全切换分支。如果文件有未保存的编辑内容，VSCode 的 Git 面板会显示这些“未暂存的更改”，此时点击分支名切换，VSCode 会弹出提示：“There are uncommitted changes. Switch anyway?” —— 选“是”可能丢内容，选“否”就得先处理。
所以关键不是“切换时保存”，而是“确保切换前已保存”，靠的是你配置的 files.autoSave 模式是否覆盖这个时间点。
-
onFocusChange：当你从编辑器切到源代码管理面板、终端、甚至状态栏点击分支名时，当前文件会立即保存——这是最贴近“切换分支前保存”的行为 -
afterDelay：如果你写完就停顿 1 秒以上再点分支，大概率已保存；但手速快、连敲带点，很容易卡在“已改未存”状态 -
onWindowChange：切到终端、浏览器、微信时保存——但弹个系统通知也可能触发，不稳定，不推荐 -
off：完全不自动存，全靠 Ctrl+S，切换分支前务必自己检查状态栏右下角是否显示“已保存”
为什么 onFocusChange 是最实用的选择
它和分支切换操作链路最匹配：你写完代码 → 点击左侧 Source Control 图标（焦点离开编辑器）→ 文件自动保存 → 再点状态栏分支名切换，Git 就不会拦你。
注意两个细节：
- 它只保存当前活动编辑器中的文件，其他打开但未聚焦的 tab 不会保存
- 如果开了多根文件夹工作区，
onFocusChange仍只作用于当前激活的编辑器，不会批量保存所有项目下的修改 - 语言专属设置可能关掉它：比如你在
.vscode/settings.json里为[markdown]设了"files.autoSave": "off"，那 .md 文件切分支前就不会自动存
别指望格式化插件帮你兜底
很多人开了 editor.formatOnSave，误以为“只要保存就会格式化+落盘”，但这里有个坑：
- 如果 Prettier 或 Black 找不到配置（比如没
.prettierrc或pyproject.toml），格式化失败 → VS Code 有时会静默放弃保存，文件实际没写入磁盘 - 你看到编辑器右上角有“已保存”提示，但文件系统里仍是旧内容——用
git status一查就露馅 - 临时验证方法：改一行代码，切到终端执行
git status，看有没有显示修改；没显示，说明根本没保存成功
真正安全的分支切换流程
不管 autoSave 怎么配，以下三步才是零风险底线：
- 切换前扫一眼源代码管理面板（
Ctrl+Shift+G），确认“Changes”列表为空，或至少没有你要带走的未保存内容 - 如果还有修改，用右上角
⋯→Stash Changes暂存（勾选“Include untracked files”以防漏掉新文件） - 切完分支后，立刻从
⋯→Stashes→Apply Stash恢复，别等忘了 stash 名称
autoSave 是辅助，stash 是保险绳。很多人栽在“以为保存了”，其实只是编辑器 UI 欺骗了自己——磁盘没写、Git 没见、切换就丢。
