Git多个用户ID适配


用于个人和工作的 Git 账户进行提交,而无需手动重置你的配置。

Git 是一个分布式版本控制软件,最初由 林纳斯·托瓦兹 创作,于 2005 年以 GPL 协议发布。最初目的是为更好地管理 Linux 内核开发而设计。很多著名的软件都使用 Git 进行版本控制,其中包括 Linux 内核、X.Org 服务器和 OLPC 内核等项目的开发流程。

Git多个用户ID适配


1. 背景介绍

存在痛点的时候,我们才会体会到其存在的好处了!

Git多个用户ID适配

Git 的  git config 命令可以让你为 Git 设置用户名、邮箱等全局选项和配置。其有很多选项和配置,其中一个就是  includeIf 选项,它能够帮助我们在拥有多个 Git 用户的时候可以灵活的切换到对应的用户上,且使用起来非常方便。

比如说,我们在工作时间需要处理公司的工作,不管是 GitHub 也好,还是 GitLab 也罢。同时,我们又在业余的时间为开源项目提交代码做贡献。在这种情况下,我们肯定不想在这两种不同的情况下使用一个共同的配置。我们肯定是希望,在不同的情况下使用不同的配置,尤其是当我们只有一台计算的话。

我的情况就是上述表述的那样,所以我需要在 Git 配置中保留两种不同的邮件 ID。这样一来,上班时间使用公司邮箱进行代码的提交,而在下班之后可以使用 GitHub 的邮箱进行自己茶余饭后的娱乐。而应该如何配置呢?这就是一个非常总要的问题了!


2. 选项使用

其实就是使用 includeIf 选项来完成的,见证奇迹吧!

2017 年,Git 新发布的版本 2.13.0 包含了一个新的功能 includeIf 配置,可以把匹配的路径使用对应的配置用户名和邮箱。

其中 includeIf.condition.path  变量,是  include  配置指令的一部分,其允许我们通过条件过滤的方式设置属于我们自己的自定义配置。includeIf 指令支持三个子关键字,分别是:gitdirgitdir/I  和  onbranch

  • [1] gitdir

关键字 gitdir:后面的内容用于全局匹配(golb模式),如果 Git 目录与模式匹配,则满足 include 条件。Git 仓库的配置,可以由程序自己发现或者通过 GIT_DIR 环境变量来配置。该模式下,可以使用标准的通配符之外,还附加了两个额外的通配符,分别是 **//** 两种,它们用于匹配多个路径。

如果该模式以 ~/ 开头的话,~ 将被环境变量 HOME 的内容所替代。如果模式以 ./ 开头的话,它将被包含当前配置文件的目录替换。

如果该模式不以 ~/ 开头的话,则 .//**/ 将自动预置。例如,我们将匹配模式从 foo/bar 变为 **/foo/bar 的话,将匹配 /any/path/to/foo/bar。如果模式以 / 结束的话,** 将被自动被添加到其尾部。例如,我们设置模式默认为 foo/ 的话,将变成 foo/** 这样。换句话说,它递归地匹配 foo 和里面的所有内容。

  • [2] gitdir/I

关键字 gitdir/I:这与 gitdir 相同,只是匹配是大小写不敏感的,例如在不区分大小写的文件系统上。

  • [3] onbranch

关键字 onbranch:后面的数据被认为是一个模式!该模式下,可以使用标准的通配符之外,还附加了两个额外的通配符,分别是 **//** 两种,它们用于匹配多个路径。如果在工作树中,当前签出的分支的名称与模式匹配,则满足 include 条件。

如果模式以 / 结束的话,** 将被自动添加。例如,我们设置模式默认为 foo/ 的话,将变成 foo/** 这样,它匹配所有以 foo/ 开头的分支。如果您的分支是按层次结构组织的,并且您希望将配置应用于该层次结构中的所有分支,那么这是非常有用的。

[core]
    filemode = false

[diff]
    external = /usr/local/bin/diff-wrapper
    renames = true

[branch "devel"]
    remote = origin
    merge = refs/heads/devel

; include if $GIT_DIR is /path/to/foo/.git
[includeIf "gitdir:/path/to/foo/.git"]
    path = /path/to/foo.inc

; include for all repositories inside /path/to/group
[includeIf "gitdir:/path/to/group/"]
    path = /path/to/foo.inc

; include for all repositories inside $HOME/to/group
[includeIf "gitdir:~/to/group/"]
    path = /path/to/foo.inc

; relative paths are always relative to the including
; file (if the condition is true); their location is not
; affected by the condition
[includeIf "gitdir:/path/to/group/"]
    path = foo.inc

; include only if we are in a worktree where foo-branch is
; currently checked out
[includeIf "onbranch:foo-branch"]
    path = foo.inc

3. 内容配置

在我们给定的配置文件中,配置我们自己需要区别的配置!

  • [1] 全局配置文件
    • ~/.gitconfig 里面原有的 user 部分需要删除掉
    • ~/.gitconfig 里面的 includeIf 后面的 path 需要以 / 结尾
    • 个人项目目录和公司项目目录需要是非包含关系,即非父子目录等
# 配置文件地址
# 全局通用配置文件
$HOME/.gitconfig

# 一切献给了开源
[includeIf "gitdir:~/github_dir/"]
    # 个人项目配置文件
    path = ~/.git/.gitconfig-github

# 一切献给了工作
[includeIf "gitdir:~/working_dir/"]
    # 公司项目配置文件
    path = ~/.git/.gitconfig-working
  • [2] 个人项目配置文件
$ cat ~/.git/.gitconfig-github
[user]
    name = yourname-self
    email = [email protected]
  • [3] 公司项目配置文件
$ cat ~/.git/.gitconfig-working
[user]
    name = yourname-self
    email = [email protected]

文章作者: Escape
版权声明: 本博客所有文章除特別声明外,均采用 CC BY 4.0 许可协议。转载请注明来源 Escape !
  目录