git 查看全局配置

stevenzqzq

已于 2025-04-04 18:23:27 修改

阅读量2.8w

点赞数 1

分类专栏： Android 文章标签： git

于 2018-08-04 17:20:55 首次发布

本文链接：https://blog.csdn.net/qq_26296197/article/details/81413156

版权

Android 专栏收录该内容

232 篇文章

订阅专栏

Git 配置详解

Git 的配置分为不同的作用范围，理解它们的优先级很重要。我们可以使用 git config 命令来设置和查看 Git 的配置信息。

1. 查看已有的 Git 配置

git config --list

⚠️ 注意：

这个命令会列出 所有作用范围的 Git 配置，但不会标明每个配置来自哪个文件。
如果不同级别的配置项重复，则优先级高的会覆盖低优先级的值（见下方优先级规则）。

如果想查看特定范围的配置，可以使用：

git config --local --list   # 仅查看当前仓库的配置
git config --global --list  # 仅查看当前用户的全局配置
git config --system --list  # 仅查看系统级的配置

2. 设置 Git 用户名和邮箱

Git 允许在不同级别上设置 user.name 和 user.email，作用范围如下：

（1）全局配置（适用于所有 Git 仓库）

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

这些配置会存储在 ~/.gitconfig 文件中，对 所有仓库 生效。

（2）项目级配置（仅对当前仓库生效）

git config user.name "Project Specific Name"
git config user.email "project_email@example.com"

这些配置会存储在 .git/config 文件中，仅对当前仓库有效，会覆盖全局配置。

3. 配置的优先级

Git 会按以下顺序读取配置（优先级从高到低）：
1️⃣ 项目级（仅当前仓库生效） → .git/config
2️⃣ 全局级（当前用户的所有仓库生效） → ~/.gitconfig 或 ~/.config/git/config
3️⃣ 系统级（所有用户的 Git 配置） → /etc/gitconfig

🔹 示例：

git config --global user.name "Global Name"
git config user.name "Local Name"
git config --list

实际生效的 user.name 是 Local Name，因为项目级配置优先级更高。

如果想知道某个具体的 user.name 来自哪个文件，可以使用：

git config --show-origin user.name

这将显示配置的来源文件。

4. 可能的误解（避免常见错误）

❌ 误解：

“git config --list 显示的和 git config --global user.name 设置的不一样，是不是设置失败了？”

✅ 正确理解：

git config --list 显示的是最终生效的配置，而不区分来自哪一层。如果项目级配置覆盖了全局配置，就不会看到 --global 设置的值。

如何检查具体的配置？

git config --global --list  # 仅查看全局配置
git config --local --list   # 仅查看当前仓库的配置
git config --show-origin user.name  # 查看具体配置的来源

5. 取消 Git 配置

如果设置错了，可以使用 --unset 删除某个配置：

git config --global --unset user.name  # 删除全局 user.name
git config --local --unset user.name   # 删除当前仓库的 user.name

或者手动修改对应的 .git/config 或 ~/.gitconfig 文件。

总结

✅ git config --list 会列出所有配置，但不会标明来源，优先级高的配置会覆盖低优先级的配置。
✅ 优先级：项目级（最高） > 全局级 > 系统级（最低）。
✅ 可以用 git config --show-origin 检查某个配置的来源，避免误解。
✅ 设置错误时，可以使用 git config --unset 来取消配置。

二 git 项目级配置（仅对当前仓库生效）教程

Git 项目级配置教程（仅对当前仓库生效）

Git 允许在项目级（仓库级）进行配置，这些设置仅影响当前 Git 仓库，不会影响全局的 Git 配置或其他项目。

1. 什么是 Git 项目级配置？

项目级配置存储在当前仓库的 .git/config 文件中，仅适用于该仓库。
它的优先级高于全局（~/.gitconfig）和系统级（/etc/gitconfig）配置。

优先级顺序

1️⃣ 项目级（当前仓库） → .git/config （优先级最高）
2️⃣ 全局级（当前用户所有仓库） → ~/.gitconfig
3️⃣ 系统级（所有用户） → /etc/gitconfig（优先级最低）

如果项目级配置与全局配置或系统配置冲突，Git 优先使用项目级配置。

2. 查看项目级 Git 配置

git config --local --list

或者直接查看 .git/config 文件：

cat .git/config

3. 设置项目级 Git 配置

如果只想对当前仓库进行特定配置（例如不同的用户名或邮箱），可以使用以下命令：

（1）设置用户名和邮箱

git config user.name "ProjectUser"
git config user.email "project@example.com"

🔹 这两个配置仅影响当前仓库，不会影响其他 Git 项目。

（2）设置默认分支名称

默认情况下，Git 初始化仓库时使用 master 作为主分支名称，可以修改为 main：

git config init.defaultBranch main

（3）启用颜色高亮

git config color.ui auto

（4）设置别名

可以为常用命令创建快捷方式：

git config alias.co checkout  # 以后可以用 `git co` 代替 `git checkout`
git config alias.br branch    # `git br` 代替 `git branch`
git config alias.cm "commit -m"  # `git cm "message"` 代替 `git commit -m "message"`

（5）配置 `core.ignorecase`

如果的 Git 仓库在 Windows 上运行，默认情况下 Git 会忽略大小写，可以关闭它：

git config core.ignorecase false

这样，Git 便会区分大小写的文件名。

（6）配置 `core.autocrlf`

如果团队成员在不同操作系统（Windows/Linux/macOS）开发，可能会遇到换行符格式问题，可以用以下方式解决：

git config core.autocrlf true  # Windows 用户
git config core.autocrlf input # macOS / Linux 用户

true（Windows）：会把 CRLF 换行符转换为 LF。
input（Linux/macOS）：提交时转换 CRLF 为 LF，但检出文件时不转换。

（7）配置 `pull.rebase`

默认情况下，git pull 会执行 merge，如果想让 git pull 默认使用 rebase，可以这样设置：

git config pull.rebase true

这样，git pull 会自动执行 rebase，避免产生额外的 merge commit。

4. 删除项目级 Git 配置

如果不想要某个配置项，可以使用 --unset 进行删除：

git config --unset user.name
git config --unset user.email

或者直接编辑 .git/config 文件，手动删除相关配置项。

5. 彻底清除项目级 Git 配置

如果想完全移除当前仓库的 Git 配置，可以直接删除 .git/config：

rm -rf .git

⚠️ 注意：这会删除整个 Git 版本控制信息，谨慎操作！

6. 如何检查某个配置的来源？

有时候可能不确定某个配置来自哪里，可以用以下命令：

git config --show-origin user.name

它会显示 user.name 是从哪个配置文件加载的，比如：

file:/home/user/myrepo/.git/config    user.name=ProjectUser

这样就能确定该配置是来自当前仓库的 .git/config。

7. 结论

✅ 项目级 Git 配置存储在 .git/config，只影响当前仓库。
✅ 优先级最高，会覆盖全局和系统级配置。
✅ 可以为当前项目自定义用户名、邮箱、分支、别名等设置。
✅ 使用 git config --local --list 查看项目级配置。
✅ 通过 git config --unset 删除配置，或者直接编辑 .git/config。

这样，就可以在不同项目里使用不同的 Git 配置，更灵活地管理的 Git 版本控制！