git switch 是 Git 官方推荐的分支切换命令，VSCode 底层调用它但存在状态判断与缓存问题：.git 必须在根目录、需启用 git.enabled、脏工作区会阻止切换、已打开文件不会自动刷新、远程分支需先 fetch、worktree 不联动、冲突需手动清理标记并暂存。
git switch 是当前 Git 官方推荐的分支切换命令，VSCode 底层调用的就是它（Git 2.23+ 默认行为），不是 git checkout。点一下状态栏就切走，看起来简单，但实际卡住、切不动、切完代码没变——这些问题基本都出在「状态判断」和「VSCode 缓存行为」上。
状态栏点不动？先确认 Git 仓库是否被正确加载
VSCode 不是“没反应”，而是根本没识别到你的 .git。常见现象包括：左下角压根不显示分支名、点击无弹窗、分支列表为空。
-
.git必须在你打开的文件夹根目录下——子目录里有.git，VSCode 不认 - 检查设置里
git.enabled是否为true（搜这个配置项就能看到） - 多根工作区中，当前编辑的文件若不在含
.git的文件夹里，VSCode 只会响应那个“主 Git 文件夹”的状态 -
.git/config权限异常（尤其 Windows + OneDrive 场景），终端里跑git status报错，VSCode 就同步失效
点了分支名却切不到？注意“脏工作区”和远程分支可见性
报错 Your local changes would be overwritten by checkout，不是 VSCode 的锅，是 Git 在保护你——它拒绝用目标分支覆盖你未提交的修改。
- 工作区有
modified或untracked文件时，VSCode 会弹窗问是否Stash Changes；选Switch Anyway不会 stash，而是直接 abort - 列表里找不到你要的本地分支？它可能真不存在——刚新建但还没任何 commit，VSCode 有时会跳过显示（解决办法：随便改一行 →
Ctrl+K Ctrl+H暂存，分支立刻出现） - 远程分支（如
origin/feature/login）不会自动进列表，必须先执行Git: Fetch（Ctrl+Shift+P输入），或右键该远程分支选Create Local Branch From…
切换后文件内容没变？VSCode 不会自动重载已打开的标签页
状态栏显示已切到 develop，但你正编辑的 src/utils.js 还是 main 分支的代码——这不是 bug，是明确设计行为。
- 已打开且未保存的文件标签页，内容不会随分支切换自动刷新
- 必须手动关闭再重新打开该文件，或按
Ctrl+S触发保存（如果内容已被新分支覆盖，会提示冲突；否则 VSCode 会从新分支读取最新版本） - 用了
git worktree？VSCode 当前只响应主工作区的分支切换，其他 worktree 下的文件不会联动更新
合并分支时报 Conflicted？三栏界面只是辅助，关键靠手动清理标记
右键待合并分支 → Merge from… 后，冲突文件在「源代码管理」视图中标为 Conflicted，点开是三栏：Current Change、Incoming Change、Merge Result。
- 必须手动删掉
、<code>=======、>>>>> feature/login这些标记行 - 删完保存后，还得在「源代码管理」面板中右键该文件 →
Accept Merge，或终端里运行git add <file></file>，否则无法提交 - 别依赖“自动合并成功”提示——只要文件进了
Conflicted状态，就说明 Git 放弃了，必须人工干预逻辑
git switch，其余全靠你提前准备和事后验证。
