每个分支使用 gitconfig

Question

我们公司使用了许多定制的开源项目。 每当我贡献上游分支时，我都会更改为使用我的个人电子邮件/姓名。 有没有办法让每个分支都有 gitconfig？

例如我想要的是

[remote 'gerrit']
name = 'Personal Name'

[branch 'origin']
name = 'Name in company'

Answer 1

您可以为此使用结帐后挂钩。 运行

$ touch .git/hooks/post-checkout 
$ chmod a+x .git/hooks/post-checkout 

将内容添加到post-checkout脚本（根据需要编辑名称和分支）

#!/bin/bash
# $3 "0" - checking out file. "1" - checking out branch.
[[ "$3" == "0" ]] && exit 0 
branch=$(git status --short -b | cut -d' ' -f2-)
case $branch in
  gerrit*)
    git config user.name "Personal Name"
    echo "changed user.name to Personal Name"
    ;;
  master*)
    git config user.name "Company Name"
    echo "changed user.name to Company Name"
    ;;
  *)
    echo "Some other branch, what should user.name be?"
    ;;
esac

Answer 2

使用 Git 2.23（2019 年第三季度），无需 post-checkout 钩子，您可以使用官方git config条件包含，无需脚本！
条件包含机制学会了根据 HEAD 当前所在的分支进行选择。

请参阅Denton Liu ( Denton-L ) 的commit 07b2c0e （2019 年 6 月 5 日） 。
^{（由Junio C gitster合并-- gitster -- in commit 3707986 ，2019 年 7 月 9 日）}

config : 学习“ onbranch: ” includeIf条件

目前，如果用户希望每个分支都有单独的设置，他们需要手动跟踪他们的头脑中的设置，并在命令行上手动设置选项或更改每个分支的配置。

教配置“ onbranch: ” includeIf条件，以便它可以有条件地包含配置文件，如果在当前工作树中检出的分支与给定的模式匹配。

git config手册页现在包括：

onbranch ：

关键字onbranch:的数据被视为具有标准通配符和两个附加通配符**/和/** ，可以匹配多个路径组件。

如果我们在当前检出的分支名称与模式匹配的工作树中，则满足包含条件。

如果模式以/结尾， **将自动添加。
例如，模式foo/变为foo/** 。

换句话说，它匹配所有以foo/开头的分支。 如果您的分支按层次结构组织并且您希望将配置应用于该层次结构中的所有分支，这将非常有用。

所以在你的情况下：

[includeIf "onbranch:gerrit"]
  path=gerrit

在.git/gerrit文件中：

[remote 'gerrit']
  name = 'Personal Name'

---

示例：

vonc@vonvb:~/gits/src/git$ git version
git version 2.23.0.b4


vonc@vonvb:~/gits/src/git$ git config includeIf.onbranch:next.path user1
vonc@vonvb:~/gits/src/git$ git config includeIf.onbranch:pu.path user2
vonc@vonvb:~/gits/src/git$ git config --local -l
core.repositoryformatversion=0
core.filemode=true
core.bare=false
...
includeif.onbranch:next.path=user1
includeif.onbranch:pu.path=user2

设置每个分支的配置文件：

vonc@vonvb:~/gits/src/git$ git config --file=.git/user1 user.name user1
vonc@vonvb:~/gits/src/git$ git config --file=.git/user1 user.email user1@email.com

vonc@vonvb:~/gits/src/git$ more .git/user1
[user]
    name = user1
    email = user1@email.com


vonc@vonvb:~/gits/src/git$ git config --file=.git/user2 user.name user2
vonc@vonvb:~/gits/src/git$ git config --file=.git/user2 user.email user2@email.com

vonc@vonvb:~/gits/src/git$ more .git/user2
[user]
    name = user2
    email = user2@email.com

检查它是否正常工作！

vonc@vonvb:~/gits/src/git$ git config user.name
VonC

vonc@vonvb:~/gits/src/git$ git checkout next
Branch 'next' set up to track remote branch 'next' from 'origin'.
Switched to a new branch 'next'
vonc@vonvb:~/gits/src/git$ git config user.name
user1

vonc@vonvb:~/gits/src/git$ git checkout pu
Branch 'pu' set up to track remote branch 'pu' from 'origin'.
Switched to a new branch 'pu'
vonc@vonvb:~/gits/src/git$ git config user.name
user2

vonc@vonvb:~/gits/src/git$ git checkout master
Switched to branch 'master'
Your branch is up to date with 'origin/master'.
vonc@vonvb:~/gits/src/git$ git config user.name
VonC

从master到next到pu分支：三个不同的user.name ！ 每个分支一个。

没有钩子。 没有剧本。

---

如 Git 2.30（2021 年第一季度）所示，请确保使用 Git 2.24+，否则您可能会收到一些奇怪的错误消息：

请参阅Johannes Schindelin ( dscho ) 的commit f1beaae （2020 年 11 月 19 日） 。
^{（由Junio C gitster合并-- gitster -- in commit 1242501 ，2020 年 11 月 30 日）}

t1309 : 在onbranch测试用例中使用中性分支名称

^{签字人：约翰内斯·辛德林}

此补丁涉及的onbranch测试用例实际上并未尝试包含任何其他配置。 他们的目的是避免回归我们过去修复的include.onbranch:<name>.path代码中的两个错误，这些错误实际上与任何具体分支名称无关。

第一个错误已在85fe0e800ca中修复（“ config : work around bug with includeif:onbranch and early config”, 2019-07-31, Git v2.23.0-rc1 -- merge ）。
本质上，在读取早期配置时，会有一个 catch-22 试图访问 refs，因此我们根本无法在那时评估条件。 测试用例确保我们避免发出这种虚假消息：

 BUG: refs.c:1851: attempting to get main_ref_store outside of repository

第二个测试用例涉及非 Git 场景，其中我们根本没有当前分支开始（因为我们首先没有存储库），并且测试用例是在22932d9169f (" config :停止检查the_repository是否为NULL ", 2019-08-06, Git v2.24.0-rc0 -- 合并在批处理#2 中列出）以确保我们不会导致分段错误，如果代码仍然错误地尝试查看任何参考

简而言之，即使在回归的情况下，这两个测试用例都不会查看当前的分支名称。 因此，实际的分支名称根本无关紧要。 因此，我们可以轻松地在此处避免带有种族色彩的分支名称，这就是此补丁所做的。

Answer 3

我不知道有任何工具可以在更改分支后自动更改用户名和电子邮件，但是您可以在推送之前设置该信息，方法是使用诸如filter-branch类的重写历史记录的工具（并将其设置为 pre-push hook 以自动化该过程）。 您只能为特定分支设置更改作者信息。

查看以下链接了解详细信息：更改作者信息

Answer 4

Git config 支持 条件包含，这将是一个不错的解决方案，但目前唯一支持的条件是存储库的路径。 分支或远程不适合作为条件。 当我们进行提交时，本地头不必指向分支（分离的 HEAD 状态），本地分支不必具有跟踪分支。 此外，本地分支的名称不必与其跟踪分支的名称匹配。

我想到的第一个可能的解决方案是post-commit 。 提交完成后，在post-commit获取正确的名称和电子邮件，然后运行git -c user.name foo -c user.email bar commit --amend --no-edit用名称和电子邮件重写提交. 经过多次尝试，我发现它导致了一个不定式循环。 一个提交调用post-commit来运行另一个git commit 。

然后我尝试在pre-commit导出与作者和提交者的姓名和电子邮件相关的GIT_AUTHOR_NAME变量。 它也失败了。 我认为这些值必须在git commit的最开始传递，并且第一次调用pre-commit已经太晚了，更不用说稍后调用的prepare-commit-msg 、 commit-msg或post-commit 。

第三次尝试是像git $(foo) commit这样的别名，其中foo根据分支名称及其远程返回正确的-c user.name=xx -c user.email=yy 。 但是涉及 bash 脚本的git alias是一个泥坑，我就放弃了。

最后我回到post-commit ：

#!/bin/bash

head=`git rev-parse --abbrev-ref HEAD`
remote=`git config --get branch."${head}".remote`
if [ "$remote" = "origin" ];then
    git filter-branch -f --env-filter '
        export GIT_AUTHOR_NAME=xx \
        export GIT_AUTHOR_EMAIL=xx@foo.com \
        export GIT_COMMITTER_NAME=xx \
        export GIT_COMMITTER_EMAIL=xx@foo.com' \
        HEAD^..HEAD
elif [ "$remote" = "gerrit" ];then
    git filter-branch -f --env-filter '
        export GIT_AUTHOR_NAME=yy \
        export GIT_AUTHOR_EMAIL=yy@bar.com \
        export GIT_COMMITTER_NAME=yy \
        export GIT_COMMITTER_EMAIL=yy@bar.com' \
        HEAD^..HEAD
else
    echo no amend
fi

它在某种程度上起作用。 但是漏洞很明显。 其中之一是，在git cherry-pick提交其作者是其他人之后，作者姓名和电子邮件将在git filter-branch完成后成为您的。 此外，如第一段所述，如果您希望分支和远程成为这个钩子中的条件，那么您必须遵循一些严格的流程。 没有分离的 HEAD，配置中没有branch.<name>.remote 。

我认为理想的解决方案可能是别名或函数。 这个答案也给出了一个很好的提示。 为了平衡自动化程度和便利性和健壮性，最好为两种情况设置两个别名，例如git -c user.name=foo user.email=foo@com commit 。 您决定在不同分支上使用哪个别名。

Answer 5

仅供参考：确保git确实是正确的版本。 这是我的问题作为参考： includeIf with branch in git

发布它是因为性能