VSCode切换Git分支只需点击状态栏分支名，但需确保项目根目录有.git文件夹、git.showStatusbar设为true，且多根工作区中正确打开Git文件夹；远程分支需fetch后通过“Create new branch from...”创建本地分支；切换前应保存或暂存修改，否则会报错。
VSCode 里切换 Git 分支，根本不需要插件或命令行——状态栏点两下就能切，但很多人点完没反应，是因为当前工作区没识别到 Git 仓库，或者分支列表被手动关了。
状态栏 Git 分支不显示？检查这三件事
常见错误现象：main 或 develop 标签压根不出现，右下角只有个空的 Git 图标；或者点了没反应，弹不出分支列表。
- 确认项目根目录下有
.git文件夹（不是子目录里有）——VSCode 只认打开文件夹的顶层.git - 检查 VSCode 设置里是否禁用了状态栏 Git：搜索
git.showStatusbar，确保值为true - 如果用的是多根工作区（workspace），且某个文件夹没 Git，VSCode 可能默认只显示主文件夹的分支；此时需在资源管理器中右键对应 Git 文件夹 →
Reopen Folder in New Window
点开分支列表后找不到目标分支？别急着 pull
使用场景：刚 clone 仓库，或同事推了新分支，你在本地 git fetch 后仍看不到它。
- VSCode 的分支列表默认只显示
local branches（本地已存在的分支），远程分支如origin/feature/login不会直接列出 - 想基于远程分支新建本地分支？点击状态栏分支名 → 选
Create new branch from...→ 输入新分支名 → 回车，VSCode 会自动关联origin/feature/login - 如果连
origin/前缀都看不到，说明还没git fetch：按Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac）→ 输入Git: Fetch运行一次
切换分支失败报 “Your local changes would be overwritten”？别硬切
错误信息：Your local changes to the following files would be overwritten by checkout
- 这不是 VSCode 的 bug，是 Git 拒绝覆盖未提交的修改——哪怕只是改了一行注释
- 最安全做法：先保存所有文件（
Ctrl+S），再点击状态栏分支 → 选目标分支；VSCode 会自动提示是否暂存变更（Stash） - 如果明确要丢弃修改：右键资源管理器里文件 →
Discard Changes，或在源代码管理视图（Ctrl+Shift+G）里勾选文件 → 点垃圾桶图标 - 千万别在弹出警告时点 “Switch Anyway” —— 它不会帮你 stash，而是直接 abort，还可能留下冲突标记
真正容易被忽略的是：VSCode 切分支时不会自动更新编辑器里已打开但未保存的文件内容。比如你开着 src/api.js，切换到 hotfix/1.2.3 后，这个 tab 里的代码还是旧分支的版本，直到你手动重新打开它或触发保存。
