Git配置文件位置详解与常见编辑操作-git-PHP中文网

git配置分system、global、local三级，对应/etc/gitconfig（windows为git安装目录etc）、~/.gitconfig（优先于~/.config/git/config）、.git/config；--list显示合并结果，需用--get验证具体值。

git配置文件位置详解与常见编辑操作

Git配置不是“写一次就完事”，而是分三层、存三处、优先级明确——改错地方，等于白配。

三个级别对应三个物理文件，路径取决于操作系统，但结构一致：

--system：系统级，所有用户共享。Linux/macOS 是 /etc/gitconfig；Windows 是 C:Program FilesGitetcgitconfig
--global：用户级，当前登录用户的所有仓库生效。Linux/macOS 通常是 ~/.gitconfig 或 ~/.config/git/config；Windows 是 C:Users\.gitconfig
--local（也是默认级别）：仓库级，只影响当前 .git 目录所在项目。路径固定为 .git/config（无论什么系统）

注意：~/.gitconfig 和 ~/.config/git/config 在同一用户下互斥，Git 优先读前者；若你用 git config --global 写入但没生效，先检查是不是后者被意外创建并覆盖了。

因为 git config --list 是合并结果，按 local > global > system 优先级叠加后输出的最终值，不是简单拼接。它不会告诉你某项来自哪个文件。

用于撰写患者出院小结、制定个性化出院指导、模拟出院后结局、降低再入院率

下载

想确认某项是否来自本地仓库：进项目目录，运行 git config --local --get user.name
想看全局配置全貌：用 git config --global --list，而不是只看 ~/.gitconfig 文件内容——因为 core.excludesfile 指向的全局忽略文件（如 ~/.gitignore_global）里的设置也属于全局配置，但不会出现在 ~/.gitconfig 文本里
编辑器配置容易漏掉：比如 git config --global core.editor "code --wait" 生效后，~/.gitconfig 里确实多了 [core] editor = code --wait，但如果你删掉这行，Git 不会自动回退到系统默认（vi），而是直接报错找不到编辑器

安全，但有前提：必须确保语法正确，且不破坏 section 结构。Git 的 config 文件是 INI 格式，不是 JSON，不支持注释嵌套或无引号字符串含空格。

合法写法：[user] name = Alice；[core] editor = "code --wait"
非法写法：[user] name = Alice Smith（空格未引号包裹，会被截断为 Alice）；[alias] st = git status（git 前缀多余，应为 st = status）
改完建议立刻验证：git config --local --get user.name 看是否读出预期值；如果 git commit 报 fatal: empty ident name，大概率是 user.name 或 user.email 配置格式错误或为空

这些不是理论问题，是每天在终端里真实发生的阻塞点：

在非 Git 仓库目录下执行 git config --local，命令静默失败，不报错也不写入——因为没找到 .git 目录，它直接忽略 --local 切换回默认行为（等价于没加参数），结果写进了 ~/.gitconfig，你以为改的是项目配置，其实改了全局
git config --global user.email 设成公司邮箱，但某开源项目要求用 GitHub 邮箱签名；这时不能删全局配置，而应在项目里用 git config user.email "xxx@users.noreply.github.com" 覆盖，否则后续所有提交都带错邮箱
Windows 用户用记事本编辑 .gitconfig 后保存为 UTF-16 或带 BOM 的 UTF-8，Git 读取失败，表现为配置项完全不生效，且 git config --global --list 输出为空——必须用 VS Code、Notepad++ 等工具另存为 UTF-8 无 BOM 格式