git config --list 默认只显示 local 和 global 配置,不包含 system 级配置,且不标明来源;加 --show-origin 才能看清每项配置的实际路径和优先级。

git config --list 看到的配置不全?默认只显示 local + global
执行 git config --list 时,你看到的是当前仓库下生效的全部配置项,但它**默认不包含系统级(system)配置**,也不区分作用域来源。容易误以为“这就是全部”,其实可能漏了 /etc/gitconfig 或用户家目录里的 ~/.gitconfig 中被覆盖或未生效的项。
真正要确认“哪些配置正在起作用”,得加 --show-origin:
git config --list --show-origin
输出每行会带来源路径,比如:
file:/etc/gitconfig core.autocrlf=input file:/home/alice/.gitconfig user.name=Alice file:.git/config user.email=alice@work.com
- 没加
--show-origin时,同名配置(如user.name)只会显示最后一层生效值,但你看不出是哪一层写的 - local 配置(
.git/config)优先级最高,会覆盖 global 和 system;global(~/.gitconfig)又覆盖 system(/etc/gitconfig) - Windows 上 system 配置路径通常是
C:\Program Files\Git\mingw64\etc\gitconfig,不是所有安装方式都写这里
想查某个具体配置项在哪定义的?用 --get-all + --show-origin
比如你想知道 core.editor 是从哪来的、有没有被多次设置(某些脚本会反复写),直接查单个键更准:
git config --get-all --show-origin core.editor
它会列出所有匹配该 key 的配置行(包括重复的),并标明出处。这对排查“为什么 git commit 总是弹 vi 而不是我设的 code --wait”特别有用。
-
--get只返回最后一个生效值;--get-all返回全部,适合发现冲突或意外覆盖 - 如果某 key 完全没输出,说明它没在任何层级被显式设置过,此时 Git 使用内置默认值(比如
core.autocrlf在 Windows 默认为true,Linux/macOS 默认为input) - 注意大小写:Git 配置 key 全小写,
user.Name这种写法不会被识别
local/global/system 三层配置怎么手动指定查看?
不需要猜路径,Git 自带参数精准定位:
- 只看当前仓库的配置:
git config --local --list - 只看用户级配置:
git config --global --list - 只看系统级配置:
git config --system --list(需要权限,普通用户常报错unable to read config file /etc/gitconfig)
这些命令不会合并,就是纯读对应文件。适合快速验证某一层是否真写了某条配置,也方便做自动化检查——比如 CI 脚本里确认 --global user.email 是否已设。
注意:--local 必须在 Git 仓库内运行,否则报错 not in a git directory;--global 和 --system 则无此限制。
配置值带换行或空格?用 --get --path 小心解析错误
有些配置(如 include.path、core.excludesfile)值是路径,含波浪号 ~ 或变量,而 git config --get 默认不做展开。比如:
git config --get core.excludesfile
可能输出 ~/.gitignore,但实际生效的是展开后的绝对路径。这时候应该用:
git config --get --path core.excludesfile
它会自动把 ~ 替换成家目录、处理 $HOME 等环境变量。
-
--path只对路径类配置有意义,对user.name这种纯文本没影响 - 如果配置值本身含换行(极少见),
--get会截断,必须用--get-all并自行处理换行符 - 别依赖
git config --list输出做字符串解析——它的格式不保证稳定,不同 Git 版本可能微调空格或顺序
配置生效逻辑比看起来绕,尤其当多个层级存在同名项、路径含符号、或用了 include 引入外部文件时,--show-origin 是唯一能说清“谁在什么时候写了什么”的办法。


















