最快创建新分支的方法是点击状态栏分支名后选择“create new branch…”，该操作等价于git checkout -b，基于当前head一步创建并切换，但需确保本地已同步远程最新提交，且分支名合法、不自动推送。
点击状态栏分支名后选“Create New Branch”最直接
VSCode 里创建新分支，最快路径就是点左下角当前分支名（比如 main），弹出菜单后选 Create New Branch…。它等价于执行 git checkout -b，一步建分支并切换过去。
注意：这个操作默认基于当前 HEAD，不是远程最新提交。如果你本地没 git pull 过，新分支就从旧 commit 分叉出去——后续合入时容易多出冗余合并点。
- 分支名必须合法：
feature/login-flow可以，feature login或fix\bug会直接报错fatal: 'xxx' is not a valid branch name - 输入分支名后回车，VSCode 不会自动 push 到远程；要发布，得右键分支名 → Publish Branch，或手动运行
git push --set-upstream origin feature/login-flow - 想基于某个历史 commit 创建？先在 SCM 视图里右键那个 commit → Checkout Revision，再点状态栏创建
用命令面板（Ctrl+Shift+P）更可控
按 Ctrl+Shift+P（macOS 是 Cmd+Shift+P），输入 Git: Create Branch 回车，比点菜单少一步悬停判断，适合手快或鼠标不便时用。
它和状态栏操作行为一致，但好处是能明确看到当前所在分支名（高亮显示），避免误操作。如果列表为空，说明 VSCode 没识别到 Git 仓库——先跑 git rev-parse --is-inside-work-tree 确认返回 true。
- 若 .git 目录被杀毒软件锁死（Windows 常见），VSCode 插件加载失败，命令面板也调不出 Git 相关命令
- 多根工作区（multi-root workspace）下，只有第一个含
.git的文件夹会被监听；其他子目录的Git: Create Branch可能无响应 - 创建完不会自动刷新已打开的文件标签页——比如你之前开着
src/index.js，切过去后内容还是旧分支的，得手动关闭再重开
远程分支不存在？先 fetch 再创建
右键远程分支（如 origin/feature/new-api）→ Create Local Branch From…，VSCode 会自动执行 git switch --track origin/feature/new-api，等价于先 git fetch 再建立跟踪分支。
但如果你只点了状态栏或用了命令面板，而远程分支还没拉下来，它根本不会出现在可选列表里——这不是功能缺失，是本地没同步元数据。
- 手动补救：终端运行
git fetch origin，再按Ctrl+Shift+P→ 输入Git: Sync刷新分支缓存 - 某些团队习惯把远程分支命名成
refs/remotes/origin/xxx形式，VSCode 默认只显示简化名（origin/xxx），不用管前缀 - 创建后发现基线不对，别删分支重来；切过去执行
git reset --hard origin/develop（慎用）或git rebase origin/develop更安全
为什么创建后文件没变、或者提示“Your local changes would be overwritten”
VSCode 创建分支本身不改动工作区文件，只是更新 HEAD 指针。但如果你当前有未提交修改，且目标分支对应文件内容不同，切换动作就会被拦截——这是 Git 层面保护，不是 VSCode bug。
它弹出的选项只有两个：Stash 或 Discard Changes，不会帮你选择性保留部分改动。真要保留一部分，得提前用终端 git add -p 分块暂存。
- 小圆点警告：状态栏分支名旁有个橙色小圆点，代表有未提交变更；点分支切换前先看一眼，比事后处理冲突省事得多
- 切换后编辑器内容“没更新”，大概率是缓存问题——关掉所有已打开的标签页，再从资源管理器里重新点开文件
- 极少数情况是 Git index 损坏，运行
git reset --mixed后重试即可恢复
