更改 Git 远程 HEAD 以指向除 master 之外的其他内容

Question

如何将 Git 远程的 HEAD 引用设置为指向“master”之外的其他内容？

我的项目有一个不使用“主”分支的政策（所有分支都必须有有意义的名称）。此外，规范的主存储库只能通过 ssh:// 访问，没有 shell 访问权限（如 GitHub 或 Unfuddle）。

我的问题是远程存储库仍然有对 refs/heads/master 的 HEAD 引用，但我需要它指向不同的分支。这导致了两个问题：

1. 在克隆 repo 时，有这个，

   警告：远程 HEAD 引用不存在的 ref，无法结帐。

   这令人困惑和不便。

2. 基于 Web 的代码浏览器依赖 HEAD 作为浏览树的基础。那么我需要 HEAD 指向一个有效的分支。

Answer 1

几乎一年前就有same question on GitHub。

这个想法是重命名主分支：

git branch -m master development
git branch -m published master
git push -f origin master 

让master拥有你希望人们使用的东西，并在分支中完成所有其他工作。

（“git-symbolic-ref HEAD refs/head/published”不会传播到远程仓库）

这类似于“How do I delete origin/master in Git”。

---

正如this thread 中所说：（强调我的）

“git clone”只创建一个本地分支。
为此，它会查看远程仓库的HEAD ref，并创建一个与它引用的远程分支同名的本地分支。

所以总结一下，你有 repo A 并克隆它：

• HEAD 引用 refs/heads/master 并且存在
  -> 你会得到一个名为master 的本地分支，从origin/master 开始

• HEAD 引用 refs/heads/anotherBranch 并且存在
  -> 你会得到一个名为anotherBranch 的本地分支，从origin/anotherBranch 开始

• HEAD 引用 refs/heads/master 并且不存在
  ->“git clone”抱怨

不确定是否有任何方法可以直接修改 repo 中的 HEAD 引用。

（我知道这是你问题的全部重点；））

---

也许唯一的方法是"publication for the poor"，你：

 $ git-symbolic-ref HEAD refs/head/published
 $ git-update-server-info
 $ rsync -az .git/* server:/local_path_to/git/myRepo.git/

但这将涉及对服务器的写访问，这并不总是可能的。

---

正如我在“Git: Correct way to change Active Branch in a bare repository?”中解释的那样，git remote set-head 不会改变远程仓库中的任何内容。

它只会更改存储在本地仓库中的远程跟踪分支，位于remotes/<name>/HEAD。

---

在 Git 2.29（2020 年第四季度）中，失败的“git remote set-head^(man)”仍然表示暗示操作已通过，这具有误导性。

参见Christian Schlack (cschlack) 的commit 5a07c6c（2020 年 9 月 17 日）。
^{（由 Junio C Hamano -- gitster -- 合并于 commit 39149df，2020 年 9 月 22 日）}

remote：set-head 失败时不显示成功消息

^{签字人：Christian Schlack}

在出现错误时抑制消息“origin/HEAD set to master”。

$ git remote set-head origin -a
error: Not a valid ref: refs/remotes/origin/master
origin/HEAD set to master

Answer 2

更新：这仅适用于存储库的本地副本（“客户端”）。请在下方查看其他人的 cmets。

使用最新版本的 git（2014 年 2 月），正确的程序是：

git remote set-head $REMOTE_NAME $BRANCH

例如，将远程origin 上的头部切换到分支develop 将是：

git remote set-head origin develop

Answer 3

既然你提到了 GitHub，要在他们的网站上做，只需进入你的项目，然后...

admin > Default Branch > (choose something)

完成。

Answer 4

见：http://www.kernel.org/pub/software/scm/git/docs/git-symbolic-ref.html

这将设置 git 存储库中的默认分支。您可以在裸存储库或镜像存储库中运行它。

用法：

$ git symbolic-ref HEAD refs/heads/<branch name>

Answer 5

（已经有基本相同的问题“create a git symbolic ref in remote repository”，没有得到普遍的答案。）

但是对于各种 git“农场”（多个用户可以通过受限接口管理 git repos：通过 http 和 ssh）有特定的答案：http://Github.com、http://Gitorious.org、http://repo.or.cz、Girar（ http://git.altlinux.org)。

这些具体答案可能对阅读此页面并考虑这些具体服务的人有用。

• 现在他们有一个下拉菜单，用于在 http://repo.or.cz 处选择 HEAD 分支（例如：http://repo.or.cz/editproj.cgi?name=for-me-and-for-all_imz.git）；
• 和 http://gitorious.org（查看设置中的某处）；
• 在 http://GitHub.com：admin > Default Branch >（选择一些东西）（感谢@srcspider 的回答）；
• 由于v2.6，默认分支可以设置在Web interface under 'Projects' > 'List' > > 'Branches'。在 v2.12 中，Gerrit added a new set-head command 可以是 used over ssh。
• 和 Girar（在http://git.altlinux.org 上运行以构建 ALT 发行版的软件包），可以使用 ssh 接口： $ ssh git.alt help | fgrep branch default-branch <path to git repository> [<branch>] $ 例如 ssh git.alt default-branch packages/autosshd.git sisyphus 将远程仓库 autosshd.git 中的 HEAD 更改为指向 sisyphus 分支。

Answer 6

如果您可以从 shell 访问远程存储库，只需进入 .git（或主目录，如果它是一个裸存储库）并更改 HEAD 文件以指向正确的头。例如，默认情况下它总是包含'refs: refs/heads/master'，但如果你需要 foo 作为 HEAD，只需编辑 HEAD 文件并将内容更改为'refs: refs/heads/foo'。

Answer 7

您可以仅使用瓷器 Git 命令创建一个分离的 ma​​ster 分支：

git init
touch GO_AWAY
git add GO_AWAY
git commit -m "GO AWAY - this branch is detached from reality"

这给了我们一个带有粗鲁信息的 ma​​ster 分支（你可能想要更有礼貌）。现在我们创建我们的“真实”分支（我们称它为 trunk 以纪念 SVN）并将其与 ma​​ster 分离：

git checkout -b trunk
git rm GO_AWAY
git commit --amend --allow-empty -m "initial commit on detached trunk"

嘿，快！ gitk --all 将显示 ma​​ster 和 trunk 之间没有链接。

这里的“魔法”是 --amend 导致 git commit 创建一个与当前 HEAD 具有相同父级的新提交，然后让 HEAD 指向它.但是当前的 HEAD 没有父级，因为它是存储库中的初始提交，因此新的 HEAD 也没有得到父级，从而使它们彼此分离。

旧的 HEAD 提交不会被 git-gc 删除，因为 refs/heads/master 仍然指向它。

--allow-empty 标志是唯一需要的，因为我们正在提交一个空树。如果在 git rm 之后有一些 git add，那么就没有必要了。

事实上，您可以随时通过在存储库中对初始提交进行分支、删除其树、添加您的分离树、然后执行 git commit --amend 来创建分离分支。。 p>

我知道这并没有回答如何修改远程存储库上的默认分支的问题，但它给出了关于如何创建分离分支的明确答案。

Answer 8

与问题有关，我在搜索时最终到了这里：

如何让本地存储库了解 GitHub 上更改的默认分支

为了完整起见，添加答案：

git remote set-head origin -a

Answer 9

首先，创建您想要设置为默认的新分支，例如：

$>git branch main

接下来，将该分支推送到origin：

$>git push origin main

现在，当您登录您的 GitHub 帐户时，您可以转到您的存储库并选择设置>默认分支，然后选择“main”。

然后，如果你这样选择，你可以删除 master 分支：

$>git push origin :master

Answer 10

对于 gitolite 人，gitolite 支持名为 -- 等待 -- symbolic-ref 的命令。如果您对 repo 有 W（写）权限，它允许您远程运行该命令。

Answer 11

只需登录您的 GitHub 帐户，然后在导航菜单的最右侧选择 Settings，在 Settings 选项卡 中选择 Default Branch 并返回对我有用的存储库主页。