一文搞懂Git配置文件在不同系统中的位置-git-PHP中文网

git配置有三个层级：系统级（/etc/gitconfig或git安装目录下etc/gitconfig）、全局级（~/.gitconfig）、仓库级（.git/config），优先级依次递减，高优先级配置覆盖低优先级同名项。

一文搞懂git配置文件在不同系统中的位置

Git 配置文件不是“一个文件”，而是三个层级、位置不同、优先级不同的配置源。搞不清这点，就容易出现 git config --global 设了却没生效、或者改了 .git/config 却影响不到其他仓库的情况。

这个选项读写的是系统级配置，对所有用户和所有仓库生效，但普通用户通常没有写权限，也不建议随意修改。

Linux/macOS：/etc/gitconfig（注意不是 ~/.gitconfig）
Windows：一般在 Git 安装目录下，比如 C:Program FilesGitmingw64etcgitconfig；如果 Git 装在 D:Git，那路径就是 D:Gitmingw64etcgitconfig
执行 git config --system --list 时若报错 “Permission denied”，说明你没权限写，只读是正常的
不推荐日常使用 --system，除非你在管理团队统一开发环境

这是最常被用到的配置层级，对应当前用户的全局配置。它的路径取决于操作系统，且默认是隐藏文件。

Conventional Git

Conventional Commits v1.0.0 分支、工作树命名及提交信息规范，适用于 GitHub 与 GitLab 项目，用于创建分支和命名工作树等场景。

下载

macOS/Linux：~/.gitconfig（主目录下的点文件），也可 fallback 到 ~/.config/git/config（若存在）
Windows：C:Users\.gitconfig，等价于 %USERPROFILE%.gitconfig
首次运行 git config --global user.name "xxx" 会自动创建该文件；如果 cat ~/.gitconfig 报 “No such file”，说明还没初始化过任何全局配置
注意：Mac 上 Finder 默认不显示隐藏文件，别在图形界面里瞎找，直接终端里 open ~/.gitconfig 更快

每个 Git 仓库根目录下的 .git/config 是仓库级配置，只影响当前项目。它优先级最高，会覆盖 --global 和 --system 的同名设置。

路径固定：你的项目路径/.git/config，比如 /Users/me/myapp/.git/config
不要手动编辑这个文件来设用户名邮箱——应该用 git config user.name "xxx"（不带 --global），否则容易格式出错
验证是否生效：进到仓库目录后运行 git config --local --list，或直接 cat .git/config
常见误操作：在错误目录下执行 git config --local，结果提示 “not a git repository”；先确认 pwd 输出的是含 .git 子目录的路径

当多个层级都设置了同一项（比如 user.email），光看 git config --list 不知道来源，容易误判。

唯一可靠方式是加 --show-origin：运行 git config --list --show-origin
输出类似：file:/etc/gitconfig core.autocrlf=true 或 file:/Users/me/.gitconfig user.name=Me
这个命令必须在 Git 仓库内执行才有完整输出（否则可能漏掉 --local 部分）
注意：Windows 用户若看到路径里有 file:C:\Users\... 这种双反斜杠，是正常转义，不用管

真正容易被忽略的点是：配置不是“覆盖即生效”，而是“读取时按优先级动态合并”。比如你在 .git/config 里删掉 [user] 段，那这个仓库就会退回到用 ~/.gitconfig 里的值——而不是变成空。所以排查问题时，别只盯着一个文件看。