Git多账号配置

要让 GitHub 和 Gitee ，以及更多的 Git 平台账号在同一台电脑上和谐共处，通常需要配置两种不同的场景：解决多账号的身份识别问题和让代码能同时推送到多个平台。需要明确的是，Git 的全局配置（--global）在同一时间只能为电脑上所有项目设定一个统一的用户名和邮箱。要想为不同平台使用不同账号，通常通过条件包含 (includeIf)，或更主流的 SSH 多密钥配置来实现，后者因其安全性和便利性而被广泛推荐。

核心方案：使用 SSH 密钥区分 GitHub 和 Gitee

此方案通过在本地生成并配置多个 SSH 密钥，让 Git 能根据仓库 URL 自动识别该用哪个平台的账号，从而无需担心全局用户名/邮箱的冲突。

• 生成独立的 SSH 密钥对

为 GitHub 和 Gitee 分别生成密钥，并进行明确命名以便区分。

为 GitHub 生成密钥:

ssh-keygen -t yunliyo -C "[email protected]" -f ~/.ssh/id_yunliyo_github

为 Gitee 生成密钥:

ssh-keygen -t yunliyo -C "[email protected]" -f ~/.ssh/id_yunliyo_gitee

• 将公钥添加到对应平台

你需要分别将生成的公钥内容添加到 GitHub 和 Gitee 的账户设置中。

查看并复制公钥:

cat ~/.ssh/id_yunliyo_github.pub
cat ~/.ssh/id_yunliyo_gitee.pub

添加位置:

• GitHub: Settings → SSH and GPG keys → New SSH key。
• Gitee: 设置 → SSH 公钥。

将对应平台生成的 .pub 文件中的完整内容粘贴进去并保存。

• 配置 SSH 客户端

编辑（或创建） ~/.ssh/config 文件，告诉 SSH 客户端哪个域名使用哪个密钥。

# GitHub 配置
Host github.com
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_yunliyo_github
    IdentitiesOnly yes

# Gitee 配置
Host gitee.com
    HostName gitee.com
    User git
    IdentityFile ~/.ssh/id_yunliyo_gitee
    IdentitiesOnly yes

说明:

IdentityFile: 指定私钥路径，Git将依据此路径寻找对应密钥。

IdentitiesOnly yes: 强制 SSH 只使用配置文件里指定的密钥，避免因尝试过多密钥而连接失败。

• 验证配置

分别执行以下命令测试与两个平台的连接，成功后会显示“成功认证”的信息。

ssh -T [email protected]
ssh -T [email protected]

进阶技巧：让一个仓库同步到多个平台

如果你的项目需要同时推送到 GitHub 和 Gitee，可以为你的本地仓库配置多个远程地址。

方法一：手动推送（灵活）

为项目添加两个独立的远程仓库，分别指向 GitHub 和 Gitee。

git remote add github [email protected]:用户名/仓库名.git
git remote add gitee [email protected]:用户名/仓库名.git

推送时，需要手动分别推送：

git push github main
git push gitee main

这种方法的好处是控制灵活，但缺点是需要记住推送两次。

方法二：一次推送，同步双平台（最高效，推荐）

通过修改远程仓库 origin 的推送地址，让 git push 命令一次执行就自动推送到两个平台。

# 先确保已关联 GitHub 或 Gitee 任一地址作为 fetch 地址
# 然后为 origin 添加第二个推送地址
git remote set-url --add --push origin [email protected]:用户名/仓库名.git

执行 git remote -v 查看，应该看到 origin 拥有一个 fetch 地址和两个 push 地址。
配置完成后，只需执行普通的 git push，代码就会同时推送到两个平台。

测试链接

ssh -T [email protected]

如果看到类似 Hi 用户名! You've successfully authenticated... 的信息，就说明配置成功了。

补充：常见 Git 配置命令速查