开发环境
- 开发环境：Windows 11
Git 多用户提交切换指南
你是否遇到过这种场景？用公司电脑提交个人代码，结果提交记录显示的是公司用户名；或者切换了 Git 账号，却发现代码还是用旧账号提交。本文从原理到实操，介绍如何彻底搞定 Git 多用户提交切换的问题。
理解 Git 的'两张身份证'
很多新手会把 Git 的'提交身份'和'认证身份'搞混，这俩压根不是一回事。
提交身份：user.name & user.email
当你执行 git commit 时，Git 会把 user.name 和 user.email 写到提交记录里。作用仅用于展示提交者信息，比如 GitHub/GitLab 仓库的提交记录里显示的名字/邮箱。特点是可以随便改，不影响代码推送，只是'面子工程'。
认证身份：SSH 公钥/HTTPS 密码
当你执行 git push 推送代码时，远程仓库需要验证你是不是有权限，这时候用的是 SSH 公钥（或 HTTPS 密码）。作用为验证你的身份，决定你能不能推送代码。特点是和提交身份完全独立，哪怕你提交身份写的是'张三'，只要 SSH 公钥是'李四'的，照样能以李四的权限推送。
环境准备：检查基础配置
在开始切换用户前，先确认你的 Git 环境没问题。
检查 Git 版本
打开 Git Bash（Windows）/终端（Mac/Linux），执行以下命令：
# 查看 Git 版本，建议 2.0 以上版本
git --version
查看当前 Git 用户配置
# 查看全局用户配置（所有未单独配置的仓库都会使用这个配置）
git config --global user.name
git config --global user.email
# 查看当前仓库的用户配置（优先级高于全局配置）
git config user.name
git config user.email
检查 SSH 密钥（可选，针对 SSH 方式）
# 查看本地 SSH 密钥列表，确认已生成对应账号的密钥
ls -al ~/.ssh
# 正常会看到 id_rsa（私钥）、id_rsa.pub（公钥）等文件
实操步骤：3 种多用户切换方式
根据不同场景，整理了 3 种切换方式。
方式 1：仓库级独立配置（推荐！最稳妥）
这是最推荐的方式，相当于给每个仓库办'专属身份证'，互不干扰，适合长期维护多个仓库的场景。
操作步骤（以 Windows 为例）
- 打开目标仓库文件夹，右键选择「Git Bash Here」。
- 执行以下命令配置当前仓库的专属用户：
# 配置当前仓库的用户名
git config user.name "your_username"
# 配置当前仓库的提交邮箱
git config user.email "[email protected]"
# 验证配置是否生效
git config user.name
git config user.email
- 对于其他仓库（比如个人 GitHub 仓库），重复上述步骤，替换成个人账号信息即可。
核心优势
- 不会串号：每个仓库的提交身份固定，哪怕切换全局配置也不影响。
- 适合团队：公司仓库用公司账号，个人仓库用个人账号，审计不翻车。
方式 2：全局临时切换（应急用）
相当于给所有仓库换'临时身份证'，适合临时处理某个未单独配置的仓库，用完记得切回来。
# 切换全局用户为公司账号（应急处理公司仓库）
git config --global user.name "your_company_username"
git config --global user.email "[email protected]"
# 用完后切换回个人账号（避免后续提交出错）
git config --global user.name "your_personal_username"
git config --global user.email "[email protected]"
# 验证全局配置是否生效
git config --global user.name
注意事项
- 优先级：仓库级配置 > 全局配置，已单独配置的仓库不受影响。
- 风险：忘记切换的话，容易用错账号提交，建议仅应急使用。
方式 3：批处理一键切换（Windows 专属）
如果经常需要切换全局用户，不如做个'一键切换脚本'。
创建切换脚本
- 在桌面新建文本文件，重命名为
switch-git-work.bat（公司账号），内容如下：
@echo off
:: 切换到公司 Git 用户
git config --global user.name "your_company_username"
git config --global user.email "[email protected]"
:: 提示切换成功
echo ✅ 已切换到公司 Git 用户
pause
- 再创建
switch-git-personal.bat（个人账号），内容类似，替换为用户个人信息。
使用方法
双击对应的 .bat 文件，即可一键切换全局 Git 用户，ugit、SourceTree 等 Git 工具会立即读取新配置。
进阶技巧：多 SSH 密钥配置
如果你的多个 Git 账号用不同的 SSH 密钥，需要配置 SSH config 文件，避免'门禁卡'串用。
新建 SSH 配置文件
打开 Git Bash，执行以下命令创建/编辑 SSH 配置文件：
cd ~/.ssh
vim config
配置多 SSH 密钥
在 config 文件中添加以下内容（按实际情况修改）：
# 公司 Git 服务器
Host git.skyworth.com
HostName git.skyworth.com
User git
IdentityFile ~/.ssh/id_rsa_skyworth
IdentitiesOnly yes
# GitHub 个人账户
Host github.com
HostName github.com
User git
IdentityFile ~/.ssh/id_rsa_github
IdentitiesOnly yes
核心说明
Host：自定义别名，克隆仓库时用git clone [email protected]:xxx/xxx.git即可匹配对应密钥。IdentityFile：指定对应账号的 SSH 私钥路径，确保每个账号用自己的私钥。IdentitiesOnly yes：避免 Git 自动尝试所有私钥，导致远程仓库认证失败。
验证 SSH 配置
# 验证公司 SSH 连接
ssh -T [email protected]
# 验证 GitHub SSH 连接
ssh -T [email protected]
避坑指南：常见问题&解决方案
| 问题现象 | 原因分析 | 解决方案 |
|---|---|---|
| 提交记录显示的用户名不是预期的 | 仓库级配置/全局配置优先级搞混 | 1. 执行 git config user.name 查看当前仓库配置；2. 若未配置，检查全局配置；3. 为仓库添加独立配置 |
| SSH 认证失败，提示'Permission denied' | 1. SSH 私钥路径配置错误；2. 公钥未上传到远程仓库；3. 多密钥冲突 | 1. 检查 config 文件的 IdentityFile 路径；2. 重新上传公钥到远程仓库；3. 添加 IdentitiesOnly yes 配置 |
| 批处理脚本执行报错'git 不是内部命令' | Git 未添加到系统环境变量 | 1. 找到 Git 安装路径；2. 添加到系统环境变量 Path；3. 重启命令行 |
| 切换全局用户后，某个仓库的提交用户仍不变 | 该仓库已配置独立的 user.name/email | 无需处理（仓库级配置优先级更高）；若需修改，直接编辑该仓库的.git/config 文件 |
补充说明
- Git 配置的优先级：仓库级（.git/config）> 全局级（~/.gitconfig）> 系统级（/etc/gitconfig）。
- 提交身份（user.name/email）可以随时修改最近一次提交记录（
git commit --amend --author="用户名 <邮箱>"），但不建议修改已推送到远程的记录。 - SSH 公钥里的邮箱只是注释，认证时只认公钥内容，和提交邮箱无关。
