Mac上Git配置文件有三个固定位置:系统级/etc/gitconfig、全局级~/.gitconfig、仓库级.git/config,优先级从高到低为仓库级>全局级>系统级;git config --list --show-origin可一次性显示所有生效配置及其来源路径,准确可靠。

Mac 上的 Git 配置文件有三个固定位置,分别对应不同作用范围;直接用命令查比手动翻路径更可靠,尤其当文件还没生成时。
git config --list --show-origin 能一次性看到所有生效配置来源
这条命令会列出每一条配置值及其对应的文件路径,比如:
file:/etc/gitconfig [core] autocrlf=false file:/Users/you/.gitconfig [user] name=Your Name file:.git/config [remote "origin"] url=git@github.com:you/repo.git
它不依赖你是否记得路径,也不要求文件已存在——即使某个层级还没配置,其他层级的也会照常显示。遇到“为什么改了 ~/.gitconfig 没生效”,第一反应就该跑这句。
- 输出里没出现
~/.gitconfig?说明全局配置还没初始化,执行一次git config --global user.name "A"就自动生成 - 看到多行同名配置(如多个
http.proxy),说明被不同层级覆盖,优先级是.git/config>~/.gitconfig>/etc/gitconfig - 路径带
file:前缀是正常行为,不是错误
~/.gitconfig 是最常用的全局配置文件,但它默认是隐藏的
Mac 下 ~/.gitconfig 是以点开头的隐藏文件,Finder 里看不到,也不能靠双击打开。终端里用 cat 或 less 查看最直接:
使用 GitHub Next 的 CI Doctor 工作流来监视 GitHub Actions 运行、拉取失败日志、追踪重复模式,并打开带有具体下一步操作的调查问题。这是供代理作为 CI 失败调查员使用的,而不是用于将 GitHub Agentic Workflows 列为产品。
- 查看内容:
cat ~/.gitconfig(适合小文件)或less ~/.gitconfig(支持搜索、翻页) - 用编辑器打开:
open -e ~/.gitconfig(调系统文本编辑器)或code ~/.gitconfig(VS Code,需已配置 CLI 工具) - 如果提示 “No such file or directory”,别删目录或重装 Git,只需写入任意全局配置,文件就会自动创建
仓库级配置在 .git/config,别和项目根目录下的 .gitconfig 混淆
很多人在项目根目录下新建一个 .gitconfig,以为能覆盖全局设置——没用。Git 只认 .git/config 这个路径,也就是运行 git init 后自动生成的那个 .git 文件夹里的 config 文件。
- 进到项目目录后,用
cat .git/config看当前仓库专属配置 - 编辑它:
git config --local user.email "repo@special.com",注意必须加--local或在.git目录内操作 - 误删
.git/config不会丢代码,但会丢失 remote、branch 等本地设置,git remote add origin ...可恢复
系统级配置 /etc/gitconfig 很少需要动,但会影响所有用户
/etc/gitconfig 是系统级配置,普通用户通常没权限写入,一般由管理员或安装脚本设置。除非你在公司统一部署环境,否则几乎不用碰它。
- 查看它:
sudo cat /etc/gitconfig(需要密码) - 设置它:
sudo git config --system core.editor "code --wait" - 常见坑:Homebrew 安装的 Git 可能自带默认
/etc/gitconfig,里面开了core.autocrlf或init.defaultBranch,导致你本地行为和别人不一致
真正容易忽略的是配置生效顺序和缓存:改完 ~/.gitconfig 后,如果 git config user.email 还返回旧值,大概率是当前仓库的 .git/config 里写了同名项,或者用了 git -c user.email=xxx commit 这类临时覆盖。别急着重装,先用 --show-origin 把源头揪出来。










