在本地电脑配置和使用多个 Gitee 账号,核心思路是为每个账号生成独立的 SSH 密钥,并通过 SSH 配置文件(config) 来告诉系统在访问特定仓库时应该使用哪把“钥匙”。
以下是系统化、可维护的多账号配置全攻略:
第一步:为每个 Gitee 账号生成独立的 SSH 密钥
打开终端(Windows 建议使用 Git Bash 或 PowerShell,Mac 使用 Terminal),为每个账号生成专属的密钥对。建议通过有意义的命名来区分,避免混淆。
1. 生成个人账号密钥:
ssh-keygen -t rsa -b 4096 -C "your_personal_email@example.com" -f ~/.ssh/id_rsa_gitee_personal
2. 生成公司账号密钥:
ssh-keygen -t rsa -b 4096 -C "your_company_email@example.com" -f ~/.ssh/id_rsa_gitee_work
注:执行命令时,密码(passphrase)可直接按回车留空,以免每次操作都需要输入密码。
第二步:将公钥添加到对应的 Gitee 账号
- 使用文本编辑器打开生成的公钥文件(以
.pub结尾,如id_rsa_gitee_personal.pub),复制其中的全部内容。 - 登录对应的 Gitee 账号,点击右上角头像进入「设置」 -> 「安全设置」 -> 「SSH 公钥」。
- 将复制的公钥粘贴到输入框中,标题可自定义,然后点击保存。对另一个账号重复此操作。
第三步:配置 SSH 客户端(核心步骤)
在 ~/.ssh/ 目录下创建或编辑 config 文件(Windows 路径通常为 C:\Users\<你的用户名>\.ssh\config)。在该文件中配置不同账号对应的密钥路径:
# 个人账号
Host gitee-personal
HostName gitee.com
User git
IdentityFile ~/.ssh/id_rsa_gitee_personal
IdentitiesOnly yes
# 公司账号
Host gitee-work
HostName gitee.com
User git
IdentityFile ~/.ssh/id_rsa_gitee_work
IdentitiesOnly yes
注:Host 是自定义的别名,不是真实的域名;IdentitiesOnly yes 可避免系统默认密钥的干扰。
第四步:验证配置是否成功
在终端中分别测试两个账号的连接状态:
ssh -T git@gitee-personal
ssh -T git@gitee-work
如果配置成功,终端会返回类似 Hi xxx! You've successfully authenticated... 的提示信息。
第五步:在项目中克隆与使用
配置完成后,克隆或推送代码时,需要将原本地址中的 gitee.com 替换为你在 config 中设置的 Host 别名:
- 克隆新项目:
- 已有项目修改远程地址:
进入项目目录,查看并修改远程 URL:
⚠️ 关键补充:配置 Git 提交者信息
SSH 密钥仅决定了你是否有权限推送代码,而 Git 提交记录中的“作者信息”是由本地的 user.name 和 user.email 决定的。为了避免多账号提交时身份混乱,建议不要设置全局 Git 用户信息,而是进入具体的项目目录,进行局部配置:
# 在个人项目目录下执行
git config user.name "Your Personal Name"
git config user.email "your_personal_email@example.com"
# 在公司项目目录下执行
git config user.name "Your Work Name"
git config user.email "your_company_email@example.com"
按照以上步骤,你就可以优雅地在本地驾驭多个 Gitee 账号,实现不同项目和团队身份的无缝切换。
如果你使用的是 HTTPS 方式,配置多账号的逻辑与 SSH 完全不同。HTTPS 方式不需要生成密钥或配置 config 文件,而是通过**为每个项目单独配置本地凭证(Local Credential)**来实现账号隔离。
以下是使用 HTTPS 配置 Gitee 多账号的具体步骤:
第一步:清理全局配置(避免冲突)
如果你的电脑之前配置过全局的 Git 账号密码缓存,需要先将其清除,防止所有项目都默认使用同一个账号:
git config --global --unset credential.helper
第二步:为具体项目配置 HTTPS 地址
进入你需要管理的本地项目目录,将远程仓库的 URL 设置为 HTTPS 格式:
# 假设这是个人账号的项目
git remote set-url origin https://gitee.com/username/personal-project.git
# 假设这是公司账号的项目
git remote set-url origin https://gitee.com/company/work-project.git
第三步:配置本地凭证存储(核心步骤)
为了让每个项目记住自己的账号密码,且互不影响,需要在具体的项目目录下,配置仅针对当前仓库的凭证存储:
git config --local credential.helper store
注:执行此命令后,该项目的账号密码会被保存在项目内的 .git-credentials 文件中,不会影响其他项目。
第四步:拉取/推送代码并输入凭证
配置完成后,当你在该项目下首次执行 git pull 或 git push 时,终端会提示你输入 Gitee 的用户名和密码。
- 注意:出于安全考虑,Gitee 的密码通常需要使用**私人令牌(Personal Access Token)**来代替。你可以在 Gitee 网页端的「设置」->「私人令牌」中生成。
⚠️ 关键补充:配置 Git 提交者信息
与 SSH 方式相同,HTTPS 方式同样需要为每个项目单独配置提交者信息,否则提交代码时可能会显示错误的用户名。请在对应的项目目录下执行:
# 在个人项目目录下执行
git config --local user.name "Personal Name"
git config --local user.email "personal_email@example.com"
# 在公司项目目录下执行
git config --local user.name "Company Name"
git config --local user.email "company_email@example.com"
总结:HTTPS 多账号配置的核心在于**“局部配置”**。只要确保每个项目都有自己独立的 credential.helper store 和 user.name/email,就可以轻松实现多账号的无缝切换。
git clone https://账号A@gitee.com/a/a-repo.git
git clone https://账号B@gitee.com/b/b-repo.git

