git branch 输出中带 * 号的分支即为当前分支；它只列出本地分支，* 标记所在行即当前所在分支，无 * 则处于 detached head 状态。
直接看底部状态栏或运行 git branch，就能立刻确认当前分支——不需要切换、不用进配置、也不依赖 GUI 工具。
怎么一眼看出当前是哪个分支
VSCode 底部状态栏左侧会明确显示当前分支名，比如 main 或 feature/login，点击它就能弹出所有本地/远程分支列表。这是最省力的方式，但前提是项目已初始化 Git 且没被意外关闭 Git 集成。
如果状态栏没显示或你用的是终端，git branch 是最可靠的选择：输出中带 * 号的那一行就是当前分支。注意它只列本地分支，不包含 remotes/origin/xxx 这类远程跟踪分支。
- 输出为空？说明工作区不在 Git 仓库内（
.git目录缺失或路径错误） - 显示一堆
remotes/origin/xxx？那是git branch -a的输出，不是git branch - 状态栏显示
HEAD而不是分支名？说明你处在分离头指针（detached HEAD）状态，比如刚git checkout <commit-hash></commit-hash>过
git branch -vv 为什么比 git branch 更实用
git branch -vv 不仅标出当前分支，还会显示它跟踪的远程分支（如 [origin/main]）和最后一次提交摘要。这对判断“本地分支是否已同步”非常关键。
例如输出：* main 1234abc [origin/main: behind 2] Merge PR #42，说明本地 main 比 origin/main 落后 2 个提交——这时候直接 push 会失败，得先 git pull。
- 方括号里显示
ahead 3？表示本地有 3 个未推送到远程的提交 - 方括号为空（如
[origin/main]）？说明本地和远程最新提交一致 - 远程分支名显示为
[origin/xxx: gone]？代表该远程分支已被删除，但本地还保留着跟踪引用
为什么 git status -sb 是快速验证分支状态的首选
git status -sb 输出极简：## main...origin/main 表示当前在 main 分支，且已设置跟踪 origin/main；后面还可能跟 [ahead 1, behind 2] 这种同步状态提示。
它比 git branch -vv 更轻量，不显示其他分支，适合写成 alias 或嵌入脚本做自动化检查。但注意：它不会告诉你当前分支是否已建立远程跟踪关系，只显示“如果已设置，那关系是什么”。
- 输出只有
## main（没出现...）？说明这个分支还没运行过git branch --set-upstream-to=origin/main - 输出
## HEAD (no branch)？就是 detached HEAD 状态，得用git switch -c new-branch或git checkout -b new-branch回到正常分支模式 - 在 CI/CD 脚本里建议用
git rev-parse --abbrev-ref HEAD替代，它只输出分支名字符串，无额外文本，方便变量捕获
容易被忽略的边界情况：分离头指针与标签检出
当你执行 git checkout v1.2.0 或 git checkout abc123（提交哈希），当前工作区就脱离了任何分支，进入 detached HEAD 状态。此时 git branch 输出没有 *，git status -sb 显示 HEAD，git branch -vv 则完全不列出当前状态。
这种状态本身合法（比如验证某个发布版本），但如果你在此状态下做修改并提交，新提交会变成“游离提交”，一旦切换走就难以找回——因为没有任何分支引用它。
- 误入 detached HEAD 后想保存改动？立即运行
git switch -c fix-from-tag创建新分支，把当前 HEAD 挂上去 - 不确定自己是不是 detached？
git symbolic-ref HEAD 2>/dev/null如果返回空，就是 detached；有输出如refs/heads/main才是正常分支 - CI 环境中常见
git checkout $GITHUB_SHA导致 detached，记得用git show-ref --head -s --abbrev=7 HEAD取当前提交而非依赖分支名
