git symbolic-ref head refs/heads/xxx 不能在普通仓库中使用，因为它直接修改 .git/head 符号引用而不同步更新工作区和暂存区，导致文件状态与分支指针不一致、git status 混乱、后续提交出错；该命令仅适用于裸仓库、ci脚本等无工作区场景。
git symbolic-ref HEAD refs/heads/xxx 为什么不能在普通仓库里用
因为 git symbolic-ref 直接操作 .git/HEAD 文件，不校验工作区状态、不更新索引和工作树。你在普通仓库里执行它，HEAD 指针确实会变，但工作目录文件不会同步 —— 你看到的仍是旧分支的文件，git status 会混乱，后续 git commit 可能提交到错误分支，甚至破坏暂存区。
它只适合没有工作区的环境：裸仓库（--bare）、CI 构建脚本、或你明确知道自己在绕过 Git 安全层做底层操作。
- 普通仓库请始终用
git switch或git checkout - 裸仓库中无法运行
git checkout（报错fatal: This operation must be run in a work tree），这时git symbolic-ref是唯一合法手段 - 执行前务必确认目标分支真实存在：
git show-ref refs/heads/develop，避免写入无效引用
切换裸仓库默认分支的正确命令格式
裸仓库没有工作区，所以不能靠检出（checkout）来“切换”，只能改 HEAD 的符号引用指向。标准做法是：
git symbolic-ref HEAD refs/heads/develop
这条命令把 .git/HEAD 内容从 ref: refs/heads/master 改成 ref: refs/heads/develop，此后 git log、git ls-remote 等命令默认以 develop 为基准。
- 必须用完整 ref 路径：
refs/heads/xxx，不能简写为xxx或origin/xxx - 目标分支必须已存在；如果不存在，先用
git update-ref refs/heads/xxx <commit-id></commit-id>创建 - 不要加
--no-deref—— 这个选项会让 Git 把 HEAD 当成普通文件覆盖，而不是符号引用，后果是后续所有命令失效
git update-ref 和 git symbolic-ref 的分工边界
git symbolic-ref 只负责修改符号引用（比如 HEAD 指向哪个分支），而 git update-ref 更底层，既能设普通 ref（如 refs/heads/main 指向某个 commit），也能配合 --no-deref 强制写死符号引用内容。
使用 `gh` CLI 与 GitHub 交互。通过`gh issue`、`gh pr`、`gh run` 和 `gh api` 管理 issue、PR、CI 运行以及高级查询。
- 想让裸仓库的 HEAD 指向分支？用
git symbolic-ref HEAD refs/heads/feature - 想直接把
refs/heads/staging指向某次提交（比如 CI 部署时）？用git update-ref refs/heads/staging abc123def - 想原子化地同时更新 HEAD 和一个分支指针？用
git update-ref --stdin，配合symref-update和update指令批量操作
混淆二者容易导致 HEAD 变成 detached 状态或 ref 损坏 —— 比如误用 git update-ref --no-deref HEAD refs/heads/main，会让 .git/HEAD 变成含 40 字符哈希的普通文件，Git 就不再认为它是一个符号引用。
检查与验证切换是否生效
改完 HEAD 后别直接走人，得验证。裸仓库里没 git status，但有等效命令：
git symbolic-ref --short -q HEAD
输出应为 develop（或你设的目标分支名）。如果报错或输出空，说明设置失败。
- 若输出
fatal: ref HEAD is not a symbolic ref，说明你之前用了--no-deref或手动编辑过.git/HEAD，需修复：echo "ref: refs/heads/develop" > .git/HEAD - 用
git show-ref --heads确认目标分支 ref 存在且非空 - 客户端克隆或拉取时，默认会以这个 HEAD 指向的分支为
origin/HEAD，所以它直接影响新 clone 的初始分支
裸仓库的 HEAD 切换是个单点操作，没有回滚机制 —— 写错一次，可能让下游所有 clone 都拿到错误默认分支，务必在操作前备份 .git/HEAD 文件。
