git branch 命令列出本地所有分支，当前分支前带 * 号；仅显示当前分支名用 git branch --show-current；查远程分支用 git branch -r，查所有分支用 git branch -a。

git branch 命令怎么看当前分支

执行 git branch 会列出本地所有分支，当前所在分支前面带一个 * 号。这是最直接的识别方式，不需要额外参数。

常见误区是以为没输出就代表没分支——其实一定是有的，只是可能你刚初始化仓库还没提交，git branch 默认不显示未提交过任何内容的初始分支（比如 main 或 master 还没真正创建）。此时用 git status 更可靠，它第一行就会写明 On branch main 或类似提示。

git checkout 和 git switch 切换分支的区别

git checkout 是老命令，功能多但语义模糊（既能切分支又能丢弃修改）；git switch 是 Git 2.23+ 引入的专用分支切换命令，更安全、意图更明确。

实际操作建议：

• 切已有分支：git switch （推荐）或 git checkout
• 新建并切换：git switch -c （比 git checkout -b 更直观）
• 切回上一个分支：git switch -（等价于旧版 git checkout -）

注意：git switch 不能用来恢复文件修改，这点和 checkout 不同，避免误操作丢代码。

切换失败的典型错误和应对

最常见的报错是 error: Your local changes to the following files would be overwritten by checkout，说明当前有未提交的修改，Git 拒绝切换以防冲突覆盖。

从 Git 仓库历史中彻底删除文件

|Git删除了文件，但还会在Git 仓库历史中遗留。 - 想要从 Git 历史移除敏感信息（密码、密钥、token、私钥） - 想要删除意外提交的大文件 - 想要重写 Git 历史、移除特定文件的所有痕迹 - 提到 "force push"、"重写 commit 历史" - 需要从所有分支、所有 tag 中删除某个文件

下载

这时有三个选择：

• 先提交：git add . && git commit -m "temp"
• 暂存修改：git stash，切完再 git stash pop
• 强制丢弃（谨慎）：git checkout --force 或 git switch --force ，会直接清除工作区改动

别忽略状态检查：切分支前运行 git status 看一眼，能省掉大半麻烦。

为什么 git branch 显示不出远程分支

git branch 默认只列本地分支。远程分支（如 origin/main）需要加 -r 参数：git branch -r。但注意，这只会显示你本地“记住”的远程分支列表，不是实时远端状态。

想同步最新远程分支信息，得先 git fetch；否则 git branch -r 可能漏掉别人新推的分支，也看不到已删除的分支。如果要基于远程分支新建本地分支，用 git switch --track origin/feature/login，比手动 git checkout -b + git branch --set-upstream-to 更简洁。

分支名大小写、空格、斜杠这些字符在不同系统上表现不一，尽量用小写字母加短横线（如 fix-user-auth），避免后续在 CI 或脚本里出问题。