Gitconfig Includeif 示例 - Shell-Bash

gitconfig 中的 includeif 配置选项可以根据当前环境来自动加载不同的配置文件。这个功能可以用于自动设置不同操作系统、不同 Git 服务器的访问凭证、不同项目等需要不同配置的场景，大大减少了手动修改配置文件的烦恼。

语法

[includeIf "<condition>"]
  path = <path>

其中 <condition> 是一个布尔表达式，表示当前环境是否符合要求，如果符合则加载对应的配置文件；<path> 表示要加载的配置文件的路径。

示例

以下是一些示例：

根据操作系统来加载不同的配置文件

为了便于在不同的操作系统上使用 Git，可以根据操作系统来加载不同的配置文件。

# ~/.gitconfig

[includeIf "gitdir:~/work/"]
    path = ~/.gitconfig-work
[includeIf "gitdir:~/personal/"]
    path = ~/.gitconfig-personal

[includeIf "test $(uname -s) = 'Darwin'"]
    path = ~/.gitconfig-macos
[includeIf "test $(uname -s) = 'Linux'"]
    path = ~/.gitconfig-linux

[includeIf "gitdir:/var/www/"]
    path = ~/.gitconfig-web

以上配置文件设置了五组 includeIf 规则，分别根据 Git 仓库的位置以及操作系统类型来加载对应的配置文件。

根据 Git 服务器的地址加载不同的 SSH 私钥

在使用 Git 时，通常会通过 SSH 协议来访问 Git 服务器。不同的 Git 服务器有不同的 SSH 私钥。此时，可以根据 Git 服务器的地址来加载对应的 SSH 私钥。

# ~/.gitconfig

[includeIf "git@github.com"]
    path = ~/.ssh/github
[includeIf "git@gitlab.com"]
    path = ~/.ssh/gitlab
[includeIf "git@bitbucket.org"]
    path = ~/.ssh/bitbucket

以上配置文件设置了三组 includeIf 规则，分别根据 Git 服务器的地址来加载对应的 SSH 私钥。

根据项目的类型来加载不同的配置文件

在处理不同的项目时，可能需要不同的 Git 命令别名、前置钩子、后置钩子等配置。此时，可以根据项目的类型来加载对应的配置文件。

# ~/.gitconfig

[includeIf "gitdir:~/work/project1/" && "command:git && rev-parse --show-toplevel > /dev/null && ! -e $GIT_DIR/hooks/pre-commit-all"]
    path = ~/work/project1/.gitconfig
[includeIf "gitdir:~/work/project2/" && "command:git && rev-parse --show-toplevel > /dev/null && ! -e $GIT_DIR/hooks/pre-commit-all"]
    path = ~/work/project2/.gitconfig

以上配置文件设置了两组 includeIf 规则，分别根据 Git 仓库的位置和不存在 pre-commit-all 钩子来加载对应的配置文件。

总结

gitconfig 中的 includeif 配置选项可以大大简化不同环境下的 Git 配置，让开发者可以更加专注于开发工作本身。但是，需要注意 includeif 规则的编写，以免错误地加载了不应该加载的配置文件。