你有没有遇到过这样的情况？

在一个项目里提交代码，却发现作者是公司的邮箱；回到自己的开源项目，又忘了切回个人邮箱，导致 GitHub 贡献图“断更”。这些小麻烦的背后，都指向同一个东西—— Git 的配置文件。

Git 的配置系统非常强大，但它的三层结构（system, global, local）也常常让初学者感到困惑。别担心，这篇文章会带你彻底弄清楚它们是什么、在哪里、以及如何高效地管理它们，让你的 Git 工作流变得顺滑无比。

为什么理解 Git 配置如此重要？

在我们深入细节之前，先搞清楚“为什么”。理解 Git 配置不仅仅是为了解决邮箱错乱的问题，它能帮你：

• 明确身份： 在不同的工作环境（公司、个人项目）中使用正确的用户名和邮箱。
• 提升效率： 通过设置别名（alias），将冗长的命令缩短为几个字母。
• 统一规范： 在团队项目中，通过项目级配置（local）来统一代码提交规范或工具。
• 解决网络问题： 为 Git 设置代理，解决 clone 或 push 时的网络障碍。

简单说，精通 Git 配置，是从“会用 Git”到“善用 Git”的关键一步。

Git 的三层配置体系：从系统到项目

Git 的配置信息存储在三个不同级别的文件中。当 Git 需要某个配置值时，它会从低到高依次查找这三个文件。 高层级的配置会覆盖低层级的相同配置。

这个优先级顺序是： local > global > system。

让我们逐一揭开它们的神秘面纱。

1. --system：系统级配置

这是作用范围最广的配置。它应用于一台计算机上的 所有用户和他们的所有 Git 仓库。

• 作用域： 整台机器。
• 配置文件位置：
  • 在 Windows 上，通常在 Git 的安装目录下，例如 C:\ProgramData\Git\config。
  • 在 Linux/macOS 上，通常是 /etc/gitconfig。
• 使用场景： 一般很少去动它。通常由系统管理员来设置，比如为公司所有开发人员设置统一的内部代理或证书。
• 查看命令：

  git config --system --list

2. --global：用户级配置（最常用）

这是我们最常打交道的配置级别。它应用于当前登录用户的 所有 Git 仓库。你设置的用户名、邮箱、别名等，通常都存放在这里。

• 作用域： 当前用户。
• 配置文件位置：
  • 在 Windows 上，是 C:\Users\<你的用户名>\.gitconfig。
  • 在 Linux/macOS 上，是 ~/.gitconfig 或 ~/.config/git/config。
• 使用场景： 设置你的主要开发者身份（用户名和邮箱）、全局忽略文件、命令别名等。

  重要提示： 第一次安装 Git 后，你首先就应该设置这里的 user.name 和 user.email。

• 设置命令：

  git config --global user.name "Your Name"
  git config --global user.email "your.email@example.com"

3. --local：项目级配置（最高优先级）

它的作用域最小，只对 当前这一个 Git 仓库有效。这也是它优先级最高的原因——为了让你能针对特定项目进行特殊设置。

• 作用域： 当前项目。
• 配置文件位置： 位于你的项目根目录下的 .git/config 文件中。这个文件在你 git init 时自动创建。
• 使用场景： 绝佳的场景！比如，你公司的项目要求使用公司邮箱提交，而你的个人项目使用 GitHub 邮箱。你可以在公司项目里单独设置 local 配置。
• 设置命令： （进入项目目录后执行）

  git config --local user.email "work.email@company.com"

  执行后，在这个项目里的所有提交都会使用公司邮箱，而不会影响你的 global 配置。

如何查看和管理你的 Git 配置？

知道了三层体系，我们来看看具体的操作命令。

查看所有配置（合并视图）

想知道 Git 当前最终生效的配置是什么吗？用这个命令：

git config --list

它会列出所有 system, global, local 的配置，如果同一个键在多个地方被设置，这里显示的是最终生效（即优先级最高）的那个。

超级技巧： 如果你想知道每个配置项到底来自哪个文件，使用 --show-origin 参数，它会清晰地告诉你来源。

git config --list --show-origin

查看特定级别的配置

如果你只想看某个特定级别的配置，也很简单：

git config --system --list  # 只看系统级
git config --global --list  # 只看用户级
git config --local --list   # 只看项目级

查看单个配置项

想精确查找某一个配置项的值？

git config user.name
# 输出: Your Name

Git 会按照 local > global > system 的顺序找到第一个匹配的值并返回。

修改和设置配置

设置或修改配置的命令格式是 git config [--scope] <key> <value>。

# 设置全局用户名
git config --global user.name "New Name"
# 为当前项目设置不同的提交模板
git config --local commit.template ./.gitmessage
# 删除一个配置项
git config --global --unset core.autocrlf

实用场景：让配置为你的工作流加速

理论说完了，来看点能立刻用上的实用技巧。

场景一：配置 Git 别名（Alias），效率翻倍

每次都敲 git status、git checkout 是不是有点烦？用别名来拯救你的手指！

# 将 status 缩写为 st
git config --global alias.st status
# 将 checkout 缩写为 co
git config --global alias.co checkout
# 将 branch 缩写为 br
git config --global alias.br branch
# 配置一个超酷的日志输出命令 lg
git config --global alias.lg "log --color --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev-commit"

设置完后，你只需要输入 git st、git co、git lg 即可。是不是很酷？

场景二：为不同项目设置不同身份

假设你的全局配置是个人邮箱，现在要处理一个公司项目。

1. 进入公司项目的根目录。
2. 执行以下命令：

   git config --local user.name "Your Work Name"
   git config --local user.email "your.name@company.com"

3. 搞定！现在这个项目的所有提交都会使用你的工作身份，完全不影响其他个人项目。

场景三：配置默认编辑器为 VS Code

Git 在执行需要输入的命令（如 commit）时会调用默认编辑器。如果你更喜欢用 VS Code，可以这样设置：

git config --global core.editor "code --wait"

常见问题 (FAQ)

Q1: 如果我同时在 global 和 local 设置了 user.name，哪个会生效？ A: local 会生效。Git 的配置查找顺序是 local -> global -> system，高优先级的配置会覆盖低优先级的。

Q2: 我不小心把 user.name 配置错了，怎么修改？ A: 很简单，重新执行一次配置命令即可。新值会覆盖旧值。例如，要修改全局用户名：git config --global user.name "Correct Name"。

Q3: .gitconfig 文件可以直接手动编辑吗？ A: 当然可以！git config 命令本质上就是在修改这些文本文件。直接用文本编辑器打开 ~/.gitconfig 或项目的 .git/config 文件进行修改是完全可行的，有时对于批量添加或修改别名来说，这样甚至更方便。

Q4: 公司使用代理，我该如何配置 Git？ A: 你可以在 global 配置中设置 HTTP/HTTPS 代理。

git config --global http.proxy http://proxy.company.com:8080
git config --global https.proxy https://proxy.company.com:8080

如果想取消代理，使用 --unset 参数。

总结

Git 的三层配置系统（system, global, local）为我们提供了极大的灵活性。

• system：面向整台机器，不常改动。
• global：面向当前用户，是你的“默认”配置大本营。
• local：面向单个项目，拥有最高优先级，用于处理特殊需求。

掌握了 git config 命令和这三层配置的覆盖规则，你就能像指挥官一样精确控制 Git 的每一个行为。

现在，打开你的终端，用 git config --list --show-origin 看看你的配置世界吧！你会发现更多可以优化的细节。