[Git] 关于refs/for/ 和refs/heads/

最新推荐文章于 2025-06-06 15:31:39 发布

转载最新推荐文章于 2025-06-06 15:31:39 发布 · 1.6w 阅读

git 专栏收录该内容

10 篇文章

订阅专栏

本文详细介绍了Gerrit中使用Git推送代码的不同方式及其影响。解释了refs/for/与refs/heads/的区别，前者用于创建代码审查，后者则直接提交到分支。文中还提供了具体的推送命令示例。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

1. 这个不是git的规则，而是gerrit的规则，

2. Branches, remote-tracking branches, and tags等等都是对commite的引用（reference）,引用都以 “refs/……”表示. 比如remote branch: origin/git_int(=refs/remotes/origin/git_int)， local tag: v2.0(=refs/tags/v2.0)， local branch: git_int(=refs/heads/git_int)…

3. 简单点说，就是refs/for/mybranch需要经过code review之后才可以提交；refs/heads/mybranch不需要code review。

（since you want to directly push into the branch, rather than create code reviews. Pushing to refs/for/* creates code reviews which must be approved and then submitted. Pushing to refs/heads/* bypasses review entirely, and just enters the commits directly into the branch. The latter does not check committer identity, making it appropriate for importing past project history）

如果需要code review，直接push

$git push origin master

那么就会有“! [remote rejected] master -> master (prohibited by Gerrit)”的错误信息

而这样push就没有问题，

$git push origin HEAD:refs/for/mybranch

下面一段是对“refs/for”更详细的描述：

The documentation for Gerrit explains that you push to the "magical refs/for/'branch' ref using any Git client tool".

关于refs/for/ - Lishic - Theres always a way

This image is taken from the Intro to Gerrit. When you push to Gerrit, you do git push gerrit HEAD:refs/for/<BRANCH>. This pushes your changes to the staging area (in the diagram, "Pending Changes"). Gerrit doesn't actually have a branch called <BRANCH>; it lies to the git client.

Internally, Gerrit has it's own implementation for the Git and SSH stacks. This allows it to provide the "magical" refs/for/<BRANCH> refs.

When a push request is received to create a ref in one of these namespaces Gerrit performs its own logic to update the database, and then lies to the client about the result of the operation. A successful result causes the client to believe that Gerrit has created the ref, but in reality Gerrit hasn’t created the ref at all.

After a successful patch (i.e, the patch has been pushed to Gerrit, [putting it into the "Pending Changes" staging area], reviewed, and the review has passed), Gerrit pushes the change from the "Pending Changes" into the "Authoritative Repository", calculating which branch to push it into based on the magic it did when you pushed to refs/for/<BRANCH>. This way, successfully reviewed patches can be pulled directly from the correct branches of the Authoritative Repository.

http://lishicongli.blog.163.com/blog/static/146825902013213439500/