远程新分支在本地看不到是因为未执行 git fetch，它才是拉取远程分支引用的关键第一步；git branch -a 仅显示本地缓存的远程分支，需先 fetch 才能更新 remotes/origin/* 列表并看到新分支。
远程新分支在本地看不到，不是 Git 坏了，而是它根本没被拉下来——git fetch 才是关键第一步。
为什么 git branch -a 看不到新分支
Git 默认只在克隆时同步远程分支列表，后续别人 push 的新分支不会自动出现在你的本地远程跟踪分支中。你看到的 remotes/origin/xxx 是上次 git fetch 或 git pull 时缓存的状态，不是实时快照。
-
git branch -r和git branch -a都依赖本地已知的远程引用，不触发网络请求 - 即使远程已有
feature/login，你本地没 fetch 过，就绝不会显示remotes/origin/feature/login -
git pull origin main这类命令只会更新origin/main，不会顺带把其他分支也拉下来
正确拉取远程新分支的三步操作
必须按顺序执行，跳过任意一步都可能失败或创建出无追踪关系的“游离”分支。
Git 提交信息生成器
下载
Git 提交信息生成器。根据代码变更内容自动生成符合 Conventional Commits 规范的提交信息，包含类型、范围、简短描述、详细说明和关联的 Issue/需求号。触发词：生成提交信息、提交信息、commit message、git commit、生成 commit 信息
- 运行
git fetch origin：从远程获取所有新增/更新的分支引用，刷新本地remotes/origin/*列表 - 确认分支存在：
git branch -r | grep login（替换为你要找的分支名） - 创建并关联本地分支：
git checkout -b feature/login origin/feature/login（Git 2.23+ 推荐用git switch -c feature/login --track origin/feature/login）
git checkout -b 和 git switch -c 的实际差异
两者都能创建本地分支并设置 upstream，但行为细节不同：
-
git checkout -b xxx origin/xxx：老版本兼容写法，会自动设置upstream，但若本地已有同名分支且未跟踪任何远程，会静默切换过去，不报错也不覆盖 -
git switch -c xxx --track origin/xxx：明确声明意图，如果本地分支已存在，直接报错退出，避免误操作 - 无论哪种，都**不能省略
origin/xxx** —— 写成git checkout -b xxx只会建空分支，不关联远程，后续git pull会提示 “You are not currently on a branch”
常见错误与对应修复
这些坑几乎每个团队新人第一周都会踩一次。
- 执行
git checkout feature/login报错pathspec 'feature/login' did not match any file(s) known to git：说明本地没这个分支，且远程引用也没 fetch 到，先git fetch origin - 执行
git pull提示There is no tracking information for the current branch：分支已存在但没设 upstream，运行git branch --set-upstream-to=origin/feature/login feature/login - 远程分支删了，但本地
remotes/origin/old-branch还在：用git remote prune origin清理过期远程跟踪引用
真正容易被忽略的是：fetch 不等于 pull，pull = fetch + merge，而拉新分支只需要 fetch + checkout/switch。很多人卡在第一步，却反复重试 checkout，白白浪费调试时间。
