VSCode创建新分支本质是执行git switch -c或git checkout -b，基于当前HEAD创建本地分支，不自动拉取远程最新代码、不自动推送；需手动点击“Publish Branch”或运行git push -u origin <branch-name>才能同步到远程。
VSCode 里创建新分支，本质就是执行 git switch -c 或 git checkout -b，图形界面只是封装——但封装不等于全自动，漏掉关键步骤照样出问题。
点击状态栏分支名后选“Create New Branch…”到底做了什么
它默认基于当前 HEAD（也就是你当前所在提交）创建本地分支，不会自动拉取远程最新代码，也不会自动推送到远程。很多人以为点了就“建好了”，结果发现远程看不到、同事切不到，其实是卡在了推送环节。
- 输入的分支名必须合法：
feature/login-flow✅，feature login❌（空格报错），fix/1.2.0✅（点号允许） - 如果当前工作区有未提交修改，新分支会继承这些脏状态——不是 bug，是 Git 的设计逻辑
- 创建完不会自动切换过去；你得再点一次状态栏分支名，从列表里选刚建的分支
为什么新建分支后远程看不到？必须手动 push
VSCode 创建的是纯本地分支。远程分支不存在，除非你显式推送。状态栏右下角那个“Publish Branch”按钮不是摆设，它是关键动作。
- 点击“Publish Branch”等价于运行
git push -u origin <branch-name> - 没点它，或终端里没执行对应命令，远程仓库就真的没有这个分支
- 如果推送失败（比如权限不足、分支名被保护），VSCode 只提示“Failed to publish branch”，不会说明具体原因——这时得看终端输出的原始错误信息，比如
remote: Permission to xxx denied
想基于远程分支（比如 origin/develop）建新分支，不能只靠点击
状态栏菜单里的“Create New Branch…”始终基于当前 HEAD，不支持指定上游。要真正“从 develop 拉一个新分支”，得先确保本地有 develop 的最新状态。
- 先手动执行
git fetch（或 VSCode 命令面板中运行Git: Fetch） - 再点击状态栏分支名 → 选择
origin/develop→ 点右键 → “Create Local Branch From…” - 这步才等价于
git switch --track origin/develop，新分支会自动设置 upstream - 如果跳过
fetch，VSCode 可能还在用旧的origin/develop提交记录，导致新分支基点偏移
创建分支时最容易被忽略的三个检查点
不是所有“点不动”或“建不出来”都是 VSCode 的问题，大概率是 Git 层面的状态没对齐。
- 确认当前目录是有效 Git 仓库：
git rev-parse --is-inside-work-tree返回true，否则 VSCode 根本不加载 Git 集成 - 检查
.git目录是否完整且可读写（Windows 上杀毒软件或 OneDrive 有时会锁文件） - 分支列表为空？先跑一遍
git fetch，再试Git: Sync——VSCode 不会自动定期 fetch 远程分支元数据
真正麻烦的从来不是“怎么点”，而是点之前有没有确认 HEAD 位置、有没有 fetch 到最新远程状态、有没有意识到本地分支和远程分支是两个独立实体。图形界面省了命令，但没省掉 Git 的底层规则。
