设置和配置
获取和创建项目
基本快照
分支与合并
共享和更新项目
检查和比较
打补丁
调试
电子邮件
外部系统
服务器管理
指南
管理
底层命令
- 2.48.1 → 2.50.1 无更改
-
2.48.0
2025-01-10
- 2.43.1 → 2.47.3 无更改
-
2.43.0
2023-11-20
- 2.39.1 → 2.42.4 无更改
-
2.39.0
2022-12-12
- 2.1.4 → 2.38.5 无更改
-
2.0.5
2014-12-17
概要
git symbolic-ref [-m <reason>] <name> <ref> git symbolic-ref [-q] [--short] [--no-recurse] <name> git symbolic-ref --delete [-q] <name>
描述
给定一个参数时，读取指定符号引用所指向的分支头，并输出其相对于 .git/ 目录的路径。通常你会将 HEAD 作为 <name> 参数来查看你的工作树位于哪个分支上。
给定两个参数时，创建或更新一个符号引用 <name>，使其指向指定的分支 <ref>。
给定 --delete 和一个额外参数时，删除指定的符号引用。
符号引用是一个普通文件，存储着以 ref: refs/ 开头的字符串。例如，你的 .git/HEAD 是一个普通文件，其内容是 ref: refs/heads/master。
选项
- -d
- --delete
-
删除符号引用 <name>。
- -q
- --quiet
-
如果 <name> 不是符号引用而是分离头（detached HEAD），则不发出错误消息；而是静默地以非零状态退出。
- --short
-
当将 <name> 的值显示为符号引用时，尝试缩短该值，例如从
refs/heads/master缩短为master。 - --recurse
- --no-recurse
-
当将 <name> 的值显示为符号引用时，如果 <name> 指向另一个符号引用，则跟随这样的符号引用链，直到结果不再指向符号引用（
--recurse，这是默认行为）。--no-recurse在仅解引用一层符号引用后停止。 - -m
-
使用 <reason> 更新 <name> 的引用日志（reflog）。这仅在创建或更新符号引用时有效。
注意事项
过去，.git/HEAD 是一个指向 refs/heads/master 的符号链接。当我们想切换到另一个分支时，我们执行 ln -sf refs/heads/newbranch .git/HEAD；当我们想找出当前所在分支时，我们执行 readlink .git/HEAD。但是符号链接并非完全可移植，因此它们现在已被弃用，并默认使用符号引用（如上所述）。
如果符号引用的内容正确打印，git symbolic-ref 将以状态 0 退出；如果请求的名称不是符号引用，则以状态 1 退出；如果发生其他错误，则以状态 128 退出。
