git branch 默认只显示本地分支,远程分支需用 git branch -r 查看,但该命令仅显示本地缓存的快照,非远程实时状态;要获取真实分支列表,须先执行 git fetch 或直接使用 git ls-remote --heads origin。

Git 分支不是“额外功能”,而是你每天写代码时默认该用的工作方式。不创建分支就直接在 main 上改,等于在生产环境调试——风险高、协作难、回退成本大。
git branch 列出分支时为什么看不到远程分支?
因为 git branch 默认只显示本地分支。远程分支(比如 origin/feature/login)需要显式加 -r 参数才能看到。
- 查本地分支:
git branch - 查远程分支:
git branch -r - 查全部分支(本地 + 远程):
git branch -a
注意:git branch -r 显示的是你本地缓存的远程分支快照,不是实时状态。如果别人刚推了新分支,你需要先 git fetch 才能看见。
创建并切换分支,用 git switch 还是 git checkout?
git switch 是 Git 2.23+ 引入的专用分支切换命令,语义更清晰、容错更强;git checkout 功能太重,容易误操作(比如想切分支却删了工作区文件)。
- 新建并切换:
git switch -c feature/payment - 只切换已有分支:
git switch main - 切回上一个分支:
git switch -
如果你用的是旧版 Git(git checkout -b feature/payment 仍是安全选择。但只要版本允许,优先用 switch ——它不会意外覆盖未提交修改。
git push -u origin branchname 中的 -u 是干什么的?
-u(即 --set-upstream)的作用是建立本地分支和远程分支的“跟踪关系”。没有它,下次 git push 或 git pull 就得重复写分支名。
- 首次推送必须带
-u:git push -u origin feature/payment - 之后就能简写:
git push、git pull - 验证是否设置成功:
git branch -vv,看输出里有没有[origin/feature/payment]
漏掉 -u 不会报错,但后续每次推送都得输完整命令,而且 git status 也不会提示“你的分支落后于 origin/xxx”——这个细节很多人等到协作出问题才意识到。
删除分支前最容易忽略什么?
本地分支可以随时删,但有两个硬约束:
- 不能在当前分支上删自己:
git branch -d feature/login必须在main或其他分支执行,否则报错error: Cannot delete branch 'feature/login' checked out at '/path' -
-d只删已合并分支;强行删未合并的,得用-D(大写),但会丢失提交历史——除非真确认不要,否则别手抖 - 远程分支删完本地还留着跟踪信息,要同步清理:
git branch -d -r origin/old-feature(或等下次git fetch --prune)
真正麻烦的不是删分支本身,而是删完后别人还在往已删除的远程分支 push,导致混乱。所以团队里删分支前,最好在群聊里同步一声。











