Shell / Bash大前端
Git 多用户提交身份配置与切换方法
本文介绍了 Git 多用户环境下提交身份（user.name/email）与认证身份（SSH/HTTPS）的区别，提供了三种切换用户的方法：仓库级独立配置、全局临时切换及批处理脚本。同时讲解了多 SSH 密钥的配置技巧及常见问题的解决方案，帮助开发者避免提交记录错乱，实现不同账号间的无缝切换。
本文介绍了 Git 多用户环境下提交身份（user.name/email）与认证身份（SSH/HTTPS）的区别，提供了三种切换用户的方法：仓库级独立配置、全局临时切换及批处理脚本。同时讲解了多 SSH 密钥的配置技巧及常见问题的解决方案，帮助开发者避免提交记录错乱，实现不同账号间的无缝切换。
你是否遇到过这种场景？用公司电脑提交个人代码，结果提交记录显示的是公司用户名；或者切换了 Git 账号，却发现代码还是用旧账号提交。本文从原理到实操，介绍如何彻底搞定 Git 多用户提交切换的问题。
很多新手会把 Git 的'提交身份'和'认证身份'搞混，这俩压根不是一回事。
当你执行 git commit 时，Git 会把 user.name 和 user.email 写到提交记录里。作用仅用于展示提交者信息，比如 GitHub/GitLab 仓库的提交记录里显示的名字/邮箱。特点是可以随便改，不影响代码推送，只是'面子工程'。
当你执行 git push 推送代码时，远程仓库需要验证你是不是有权限，这时候用的是 SSH 公钥（或 HTTPS 密码）。作用为验证你的身份，决定你能不能推送代码。特点是和提交身份完全独立，哪怕你提交身份写的是'张三'，只要 SSH 公钥是'李四'的，照样能以李四的权限推送。
在开始切换用户前，先确认你的 Git 环境没问题。
打开 Git Bash（Windows）/终端（Mac/Linux），执行以下命令：
# 查看 Git 版本，建议 2.0 以上版本
git --version
# 查看全局用户配置（所有未单独配置的仓库都会使用这个配置）
git config --global user.name
git config --global user.email
# 查看当前仓库的用户配置（优先级高于全局配置）
git config user.name
git config user.email
# 查看本地 SSH 密钥列表，确认已生成对应账号的密钥
ls -al ~/.ssh
# 正常会看到 id_rsa（私钥）、id_rsa.pub（公钥）等文件
根据不同场景，整理了 3 种切换方式。
这是最推荐的方式，相当于给每个仓库办'专属身份证'，互不干扰，适合长期维护多个仓库的场景。
操作步骤（以 Windows 为例）
# 配置当前仓库的用户名
git config user.name "your_username"
# 配置当前仓库的提交邮箱
git config user.email "[email protected]"
# 验证配置是否生效
git config user.name
git config user.email
核心优势
相当于给所有仓库换'临时身份证'，适合临时处理某个未单独配置的仓库，用完记得切回来。
# 切换全局用户为公司账号（应急处理公司仓库）
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
注意事项
如果经常需要切换全局用户，不如做个'一键切换脚本'。
创建切换脚本
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 工具会立即读取新配置。
如果你的多个 Git 账号用不同的 SSH 密钥，需要配置 SSH config 文件，避免'门禁卡'串用。
打开 Git Bash，执行以下命令创建/编辑 SSH 配置文件：
cd ~/.ssh
vim config
在 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 -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 commit --amend --author="用户名 <邮箱>"），但不建议修改已推送到远程的记录。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online