一文吃透 git config：Git 配置全解，告别提交身份错乱、仓库适配难题

博客标签：#Git #开发工具 #版本控制 #命令行

阅读难度：零基础友好｜实操向｜可收藏复用

前言

几乎所有开发者安装Git后，第一条命令就是配置用户名邮箱：

git config --global user.name "你的昵称"

但绝大多数人只停留在这一条命令，完全不懂 git config 的完整能力：分不清全局/本地配置优先级、公私库账号切换踩坑、换行符、编辑器、代理、别名不会自定义，最后出现提交记录不归属、代码换行冲突、命令繁琐等一堆问题。

本篇博文系统化拆解git config，从层级原理、核心命令、高频配置、踩坑方案、多场景实操全覆盖，看完彻底玩转Git自定义配置。

一、什么是 git config？

git config 是Git内置配置管理命令，核心作用：读写、修改、删除Git全局/本地运行参数，自定义Git所有行为规则。

小到提交用户名、代码编辑器，大到网络代理、合并策略、换行符校验、远程仓库地址，全部依靠git config 管控。

二、核心重点：Git三层配置层级（重中之重）

Git配置分为仓库级、用户级(全局)、系统级三层，优先级：仓库级 > 用户级 > 系统级，下层配置会直接覆盖上层同名配置，这是公私账号切换的核心原理。

核心结论：日常开发只用 –global 全局 + 默认本地仓库 即可，系统级配置非必要不修改，容易造成权限问题。

三、git config 通用基础命令合集

1. 查看配置

# 查看当前生效所有配置（合并三层配置，最常用）
git config --list

# 查看指定层级配置
git config --global --list   # 查看全局配置
git config --local --list    # 查看当前仓库配置
git config --system --list   # 查看系统配置

# 精准查询单项配置（例：查看当前提交邮箱）
git config user.email

2. 新增/修改配置

# 语法：git config [层级] 配置key 配置value
# 全局配置个人账号
git config --global user.name "ZhangSan"
git config --global user.email "zhangsan@163.com"

# 当前仓库单独配置企业账号（覆盖全局）
git config user.name "张三-公司"
git config user.email "zhangsan@company.com"

3. 删除配置

# 删除指定层级单项配置
git config --global --unset user.email

# 清空当前仓库所有自定义配置
git config --local --unset-all

4. 编辑配置文件（可视化修改）

# 直接打开全局配置文件编辑
git config --global --edit

# 直接打开当前仓库配置文件编辑
git config --local --edit

四、开发者必配高频配置（直接复制即用）

除了用户名邮箱，以下配置适配Windows/Mac/Linux全平台，解决90%开发痛点，建议全局一次性配置。

1. 身份基础配置（必配）

# 个人通用全局身份
git config --global user.name "Github昵称"
git config --global user.email "github绑定邮箱"

2. 换行符自动适配（解决跨系统代码换行冲突）

# Windows系统推荐配置
git config --global core.autocrlf true
# Mac/Linux系统推荐配置
git config --global core.autocrlf input

作用：Windows回车换行CRLF，Linux/Mac换行LF，自动转换，避免Git判定整行代码修改。

3. 设置默认编辑器

# VSCode 作为Git默认编辑器（推荐）
git config --global core.editor "code --wait"

# Notepad++ 编辑器（Windows）
git config --global core.editor "'C:/Program Files/Notepad++/notepad++.exe' -multiInst -nosession"

4. 配置命令别名（简化高频命令）

# 简化git status = git st
git config --global alias.st status
# 简化git checkout = git co
git config --global alias.co checkout
# 简化git commit = git ci
git config --global alias.ci commit
# 查看简洁提交日志
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"

5. 网络代理配置（解决Github拉取超时）

# 全局http/https代理：⚠️ 本机127.0.0.1:7890代理易出现URL格式报错、连接失败，新增兼容写法
# 标准合规代理配置（修复URL拼写报错）
git config --global http.proxy socks5://127.0.0.1:7890
git config --global https.proxy socks5://127.0.0.1:7890

# 取消代理
git config --global --unset http.proxy
git config --global --unset https.proxy

6. 合并、拉取默认策略

# git pull 默认使用rebase，减少多余合并分支
git config --global pull.rebase true
# 开启差异化合并提示
git config --global merge.conflictstyle diff3

五、高频业务场景实操

场景1：公私仓库账号分离（最常用）

痛点：全局配置个人Github邮箱，公司仓库提交后，提交记录不归属企业Git账号。

解决方案：公司项目内单独配置本地仓库身份，覆盖全局配置

# 进入公司项目文件夹执行，仅对当前项目生效
git config user.name "公司姓名"
git config user.email "企业邮箱@company.com"

场景2：排查配置覆盖问题

执行 git config --list --show-origin，可以查看每一条配置所属文件，快速定位哪一层配置覆盖了当前参数。

git config --list --show-origin

场景3：重置全部Git配置

# 清空全局所有配置
git config --global --unset-all
# 清空当前仓库配置
git config --local --unset-all

六、macOS专属：配置 ~/.ssh/id_ed25519 Git免密密钥

ed25519 是当下Git/GitHub/Gitee官方推荐密钥算法，安全性、体积、兼容性远优于老旧rsa密钥，macOS原生OpenSSH完美支持，密钥默认存储路径：~/.ssh/id_ed25519，搭配git config账号配置，实现仓库免密拉取推送。

6.1 一键生成ed25519密钥（终端执行）

# macOS终端执行，替换为你的Git平台绑定邮箱
ssh-keygen -t ed25519 -C "你的github/gitee绑定邮箱"

交互填写规范：回车全部默认，密钥自动存入 ~/.ssh/id_ed25519，无需修改存储路径；按需设置密钥密码，开机使用更安全。

6.2 查看公钥、复制配置平台

# 读取ed25519公钥，全部复制
cat ~/.ssh/id_ed25519.pub

复制整段公钥，粘贴至 GitHub/Gitee/GitLab 账号设置 – SSH公钥，保存即可。

6.3 绑定Git SSH信任+校验连通性

# 启动本机ssh-agent托管密钥（macOS必执行）
eval "$(ssh-agent -s)"
# 将ed25519私钥加入信任列表
ssh-add ~/.ssh/id_ed25519

# 校验GitHub连通性
ssh -T git@github.com
# 校验Gitee连通性
ssh -T git@gitee.com

6.4 搭配git config适配SSH仓库

保证git config邮箱和生成ssh密钥邮箱完全一致，否则依旧无法识别身份、不生成贡献绿点：

# 核对当前git邮箱，必须和ssh创建邮箱一致
git config user.email
# 不一致则修改全局邮箱对齐
git config --global user.email "密钥绑定邮箱"

七、新手高频踩坑汇总

坑1：提交代码Github不显示贡献绿点

原因：当前仓库user.email 和Github绑定邮箱不一致

解决：git config user.email 核对邮箱，修改为平台绑定邮箱即可。

坑2：修改全局配置，旧仓库不生效

原因：旧仓库已经存在local本地配置，优先级高于global全局配置

解决：进入项目执行 git config --local --unset user.email 删除本地配置，复用全局配置。

坑3：换行符频繁变更，代码全红

原因：未配置core.autocrlf，跨系统换行符不统一

解决：按照系统执行上文换行符配置即可。

坑4：macOS专属报错：git@github.com: Permission denied (publickey)

报错含义：SSH公钥校验失败、密钥未托管、git邮箱与ssh密钥邮箱不匹配、本机ssh配置受限，是macOS新版系统最高频Git报错，适配 Ventura/Sonoma/Sequoia 全版本

4.1 第一步：快速定位根因

# 终端执行诊断命令，查看ssh详细校验日志，精准定位失败点
ssh -vT git@github.com

4.2 五大逐点修复方案（按顺序执行，99%可解决）

方案1：对齐邮箱（最高发原因，联动前文git config配置）

SSH密钥绑定邮箱 ≠ Git全局提交邮箱，GitHub直接拒绝鉴权，二者必须一字不差

# 1.查看当前git生效邮箱
git config user.email
# 2.查看ssh密钥创建邮箱
cat ~/.ssh/id_ed25519.pub
# 3.不一致直接修改全局git邮箱对齐
git config --global user.email "密钥绑定邮箱"

方案2：重启ssh-agent，重新托管ed25519私钥（macOS重启终端、休眠后密钥失效）

# 重启ssh代理并添加私钥信任
eval "$(ssh-agent -s)"
ssh-add --apple-use-keychain ~/.ssh/id_ed25519

💡 新增–apple-use-keychain：密钥存入mac钥匙串，永久免重复添加，根治休眠失效问题

方案3：修复ssh权限（mac系统强制校验.ssh文件夹权限，权限过宽直接拦截）

# 修复ssh目录+密钥标准权限，固定权限即可
chmod 700 ~/.ssh
chmod 600 ~/.ssh/id_ed25519
chmod 644 ~/.ssh/id_ed25519.pub

方案4：重置GitHub后台SSH公钥

1. GitHub官网 → Settings → SSH and GPG keys
2. 删除本机旧的失效公钥
3. 重新复制 cat ~/.ssh/id_ed25519.pub 全文，新增保存

方案5：临时兜底：SSH仓库改为HTTPS仓库（无需密钥，快速兜底拉推代码）

# 进入项目目录，替换远程链接为https地址，绕过ssh鉴权
git remote set-url origin https://github.com/用户名/仓库名.git

4.3 永久根治：写入ssh全局配置，杜绝复发

# 编辑mac专属ssh配置文件
vim ~/.ssh/config

写入以下固定配置，保存退出，一劳永逸避免权限、托管报错：

Host github.com
  User git
  IdentityFile ~/.ssh/id_ed25519
  UseKeychain yes
  AddKeysToAgent yes

4.4 最终校验

ssh -T git@github.com
# 出现 Hi xxx! You've successfully authenticated 即为修复完成

八、快速记忆小结

1. 优先级：本地仓库 > 全局用户 > 系统
2. 日常只用：--global 做通用配置，不加标识做单仓库配置
3. 查配置：git config --list，改配置：直接set，删配置：–unset
4. 公私账号分离：项目内单独配置本地user信息，互不干扰

九、文末结语

git config 看似简单，实则是Git协作的底层基础。前期做好标准化配置，能规避80%的提交归属、代码格式、远程交互问题。建议大家复制本文高频配置一键配置本机Git，后续开发无需反复调试。

收藏本文，后续切换电脑、重装Git直接对照复用即可✨