VSCode创建和切换Git分支的核心是确认当前HEAD、无未提交变更、VSCode正确识别仓库：运行git rev-parse --is-inside-work-tree验证仓库状态，检查.git目录权限，执行git fetch同步远程分支，创建分支时注意基于HEAD而非远程最新提交，切换后需手动刷新已打开文件标签页。
VSCode 里创建和切换 Git 分支，核心不是“会不会点”，而是“当前 HEAD 是谁、有没有未提交变更、VSCode 有没有真正识别到仓库”——这三点没理清，点一百次分支名也没用。
点击右下角分支名没反应？先确认三件事
VSCode 状态栏的分支名是可点击的，但点了弹不出列表或直接卡住，大概率不是功能坏了，而是上下文缺失：
- 运行
git rev-parse --is-inside-work-tree，输出true才说明 VSCode 当前打开的是合法 Git 工作区；如果报错或返回false，说明只是打开了一个普通文件夹，得重新用“文件 → 打开文件夹”选中含.git目录的根路径 - 检查
.git目录是否存在且可读——Windows 上杀毒软件或 OneDrive 有时会锁死该目录，导致 VSCode 插件加载失败 - 远程分支不显示？先手动执行
git fetch，再按Ctrl+Shift+P→ 输入Git: Sync，否则新推上来的origin/feature/x不会进本地分支列表
创建分支时默认基于 HEAD，不是远程最新提交
用 Ctrl+Shift+P → Git: Create Branch 创建分支，VSCode 默认以当前工作区的 HEAD 为起点。这意味着：
- 如果你本地没
git pull，新分支就从旧提交分叉出去，后续合并可能多出无意义的分叉线 - 分支名不能含空格或反斜杠：
feature/login-flow合法，feature login或fix\bug会直接报错 - 想基于特定提交创建？先在 SCM 视图中右键目标 commit →
Checkout Revision，再执行创建分支命令
切换分支后文件内容没更新？不是 Git 问题，是 VSCode 缓存
切到 main 后，编辑器里打开的 index.js 还显示 feature/login 的代码，这不是 Git 没生效，而是 VSCode 没刷新已打开的标签页：
- 手动关闭所有已打开的文件标签页，再从资源管理器里重新点击打开——这是最可靠的做法
- 如果用了多根工作区（multi-root workspace），确保每个子文件夹都是独立 Git 仓库；否则 VSCode 只监听第一个文件夹的
.git，其他文件夹的分支切换完全不响应 - 极少数情况是 Git index 损坏，运行
git reset --mixed再重试切换
切换前有未提交修改，VSCode 不会自动 stash
当前分支有未 git add 的改动，直接点切换分支，VSCode 默认把改动“带过去”——这容易污染目标分支，尤其当你改的是配置文件或环境变量时：
- 它不会强制你 stash，但会在点击分支名后弹出提示，问是否暂存（Stash）或放弃（Discard）；这个选项只在有冲突风险时才出现
- 如果想保留部分改、丢部分，别依赖图形界面，开终端用
git checkout -p交互式处理 - 合并前务必确认当前分支干净：SCM 面板里“CHANGES”区域为空，才代表没有未提交变更
真正卡住人的从来不是分支命令本身，而是 VSCode 的缓存机制、Git 的工作区状态、以及多层嵌套的仓库结构之间那几毫秒的错位。每次操作前花 3 秒看一眼 SCM 面板顶部的分支名、CHANGES 区域、以及终端里 git status 的输出，比反复点击右下角有效得多。
