VSCode切换和创建Git分支本质是调用git switch或git checkout；卡点在于工作区是否为合法Git仓库、HEAD是否干净及远程分支是否同步。
VSCode 切换和创建 Git 分支，本质就是调用 git switch 或 git checkout，图形界面只是快捷入口；真正卡住人的，从来不是“怎么点”，而是当前工作区是否被识别为合法 Git 仓库、HEAD 是否干净、远程分支是否已同步。
状态栏点击没反应？先确认 VSCode 真的在 Git 仓库里
右下角分支名点不动、弹出空列表、甚至压根不显示——这不是功能失效，而是上下文缺失：
- 运行
git rev-parse --is-inside-work-tree，输出true才说明 VSCode 当前打开的是合法 Git 工作区；否则只是打开了一个普通文件夹 - 检查项目根目录是否存在可读的
.git目录（注意：必须是打开文件夹的顶层，子目录里的.git不会被识别） - Windows 用户特别留意杀毒软件或 OneDrive 是否锁死了
.git目录，导致 Git 插件加载失败 - 多根工作区（multi-root workspace）中，VSCode 默认只监听第一个含
.git的文件夹；其他子文件夹的分支操作完全不响应，需单独以新窗口打开
切换分支后文件内容没更新？不是 Git 没生效，是 VSCode 没刷新标签页
切到 main 后，编辑器里开着的 src/api.js 还显示 feature/login 的代码，这不是 Git 问题，而是 VSCode 缓存行为：
- 它不会自动重载已打开但未保存的文件内容，哪怕你已经成功执行了
git switch - 最可靠做法：手动关闭所有已打开的文件标签页，再从资源管理器中重新点击打开
- 如果用了多根工作区，确保每个子文件夹都是独立 Git 仓库；否则切换只影响主仓库对应文件的视图
- 极少数情况是 Git index 损坏，可尝试
git reset --mixed后重试
创建分支时默认基于 HEAD，不是远程最新提交
用 Ctrl+Shift+P → Git: Create Branch，VSCode 默认以当前工作区的 HEAD 为起点建分支：
- 如果你本地没执行
git fetch或git pull，新分支就从旧提交分出去了，可能偏离团队最新进度 - 分支名不能含空格或反斜杠：
feature/login-flow合法，feature login或fix\bug会直接报错 - 想基于特定提交创建？先在 SCM 视图中右键目标 commit →
Checkout Revision，再执行创建命令 - 右键远程分支（如
origin/feature/login）→Create Local Branch From…，等价于git switch --track origin/feature/login，会自动fetch并建立跟踪
切换失败报 “Your local changes would be overwritten”？Git 在保护你
错误信息 Your local changes to the following files would be overwritten by checkout 是 Git 的安全机制，不是 VSCode bug：
- 有未提交修改时，VSCode 不会自动
stash，但会在点击分支名后弹出提示，问是否暂存（Stash）或放弃（Discard） - 千万别点 “Switch Anyway”——它不会帮你 stash，而是直接 abort，还可能留下冲突标记
- 明确要丢弃修改：在源代码管理视图（
Ctrl+Shift+G）中勾选文件 → 点垃圾桶图标；或右键资源管理器中文件 →Discard Changes - 想保留部分改、丢部分？图形界面不够用，得开终端用
git checkout -p交互式处理
真正容易被忽略的是：VSCode 不会主动提醒你当前 HEAD 是否落后于远程，也不会在创建分支前自动 fetch。这些“安静的假设”，才是日常踩坑的根源。
