Git配置文件在哪里以及配置项的生效规则-git-PHP中文网

git配置文件有三个固定物理位置：/etc/gitconfig（系统级，管理员修改，影响所有用户）、~/.gitconfig（全局级，用户修改，影响该用户所有仓库）、.git/config（仓库级，项目内修改，仅对该仓库生效）；配置项按仓库级＞全局级＞系统级顺序覆盖。

git配置文件在哪里以及配置项的生效规则

Git配置不是存在一个地方，而是分散在三个层级的文件里，每个文件路径固定、权限不同、修改方式也不同：

/etc/gitconfig（系统级）：Linux/macOS 在 /etc/gitconfig，Windows 在 Git 安装目录下的 etc\gitconfig，比如 C:\Program Files\Git\etc\gitconfig。只有管理员能改，影响所有用户和所有仓库。
~/.gitconfig（全局级）：Linux/macOS 是 ~/.gitconfig 或 ~/.config/git/config，Windows 是 C:\Users\用户名\.gitconfig。普通用户可写，对当前用户的所有仓库生效。
.git/config（仓库级）：位于你执行过 git init 或 git clone 的项目根目录下 .git/config。只对该仓库起作用，无需额外权限，但必须先进入该仓库目录才能用 --local 修改。

当你设置相同的配置项（比如 user.name）在多个层级时，Git 不会报错或合并，而是按固定顺序“覆盖”——后读到的值生效。这个顺序就是优先级顺序：

仓库级（--local）最高：例如你在项目里运行 git config user.name "TeamA"，那这个项目就只认这个值，不管全局设了什么。
全局级（--global）次之：比如 git config --global user.name "MyName"，它会被仓库级覆盖，但能覆盖系统级。
系统级（--system）最低：比如 sudo git config --system init.defaultBranch main，它只在没被更高层设置时才起效。

执行 git config --list 会按“系统 → 全局 → 仓库”顺序列出所有配置，重复的键名会出现多次，最后出现的那个才是最终生效的值。

直接问 Git 最可靠，别猜路径或翻文件：

batch-git-url-replace

批量替换指定目录下所有 Git 仓库的远程地址（remote URL）。当用户需要将 Git 仓库从一个服务器迁移到另一个服务器时使用。触发词：git remote 替换、git url 批量修改、git 仓库迁移、更换 git 地址、批量修改 remote url。

下载

查某个配置项的来源：git config --show-origin user.name，输出类似 file:/home/user/.gitconfig user.name=MyName，清楚告诉你值在哪、从哪读的。
只看当前生效值（不带来源）：git config user.name，它自动走完三级查找，返回最终结果。
想确认是否被仓库级覆盖：cd 进项目后运行 git config --local --get user.name；如果返回空，说明没设本地值，此时走全局。

注意：git config --get 默认查的是仓库级，但如果你没进仓库目录就运行，Git 会报错 fatal: not in a git directory —— 这是初学者常卡住的地方。

Git 支持用 [include] 引入外部配置文件，比如：

[include]
    path = ~/.gitconfig-private

这种引入的文件没有独立级别，它的内容会被当作“当前配置文件的一部分”处理，优先级取决于它被 include 的位置。例如，如果写在 .git/config 里，那它的内容就等同于仓库级；如果写在 ~/.gitconfig 里，就等同于全局级。

这意味着你可能在 git config --list 里看到某个配置，却找不到它在哪个原始文件里——它藏在被 include 的文件中。排查时记得加 --show-origin，否则容易误判。