如何在多个 Git 平台玩转一个仓库

版本控制在软件开发中至关重要，而 Git 是广泛使用的代码管理工具。有时，我们可能需要在多个平台 (如 GitHub、GitLab 和 Gitee) 上同步同一 Git 仓库，以便备份、协作等。

本文将带你玩转此操作，其中关键是“配置 SSH” 和“远程仓库”。首先，我们来讲述 SSH 的配置。

配置 SSH

为确保安全和简化登录，需配置 SSH 密钥。SSH 密钥是用于身份验证的安全方式，可免密访问远程 Git 仓库。

检查现有 SSH 密钥

在生成新的 SSH 密钥之前，应该检查本地电脑是否存在现有密钥。打开终端，输入一下命令以查看是否存在现有的 SSH 密钥。

ls -al ~/.ssh

此命令将列出 .ssh 目录中的所有文件（如果存在）。如果没有想要的，需要创建新的 SSH 密钥对。

生成新 SSH 密钥

在本地电脑上生成新的 SSH 密钥。生成密钥后，可将公钥添加到 GitHub 等平台上的帐户中，以便通过 SSH 为 Git 操作启用身份验证。

打开终端输入一下命令，然后一路 Enter 键，完成密钥对的生成：

ssh-keygen -t ed25519 -C "your_email@example.com" -f ~/.ssh/id_github

在这个命令中：

ssh-keygen 用于生成、管理和转换认证密钥的工具。
-t 指定了密钥类型。ed25519 是一种现代的、安全的公钥加密算法，被广泛认为是非常强大且高效的。与 RSA 和 DSA 密钥相比，它提供了更好的安全性和性能。
-C 指定一个注释，通常是用户的电子邮件地址。
-f 指定了密钥文件的保存位置和名称。默认情况下，ssh-keygen 会生成名为 id_rsa、id_ed25519 等的文件，具体取决于所选的密钥类型。在这里，它将被保存为 ~/.ssh/id_github (私钥) 和 ~/.ssh/id_github.pub (公钥)。

相关链接：

GitHub: 生成新 SSH 密钥

GitLab: 生成 SSH 密钥对

Gitee: 生成 SSH 公钥

编辑 `~/.ssh/config` 文件

为了在一台电脑上配置多个平台的 SSH，你需要编辑 ~/.ssh/config 文件。以下是一个配置示例，分别配置了 GitHub、GitLab 和 Gitee 的 SSH：

# GitHub 配置

Host github.com

    HostName github.com

    User git

    IdentityFile ~/.ssh/id_github

    PreferredAuthentications publickey,password  # 优先使用 SSH 公钥认证，然后再尝试用户名和密码认证

    IdentitiesOnly yes

# GitLab 配置

Host gitlab.com

    HostName gitlab.com

    User git

    IdentityFile ~/.ssh/id_gitlab

    PreferredAuthentications publickey  # 仅使用 SSH 公钥认证

    IdentitiesOnly yes

# Gitee 配置

Host gitee.com

    HostName gitee.com

    User git

    IdentityFile ~/.ssh/id_gitee

    PreferredAuthentications publickey  # 仅使用 SSH 公钥认证

    IdentitiesOnly yes

在这个配置中：

Host 是你定义的别名，可以随意命名，但通常使用服务域名以方便记忆。
HostName 是实际的服务域名。
User 通常是 git，因为这是大多数 Git 服务器的默认用户名。
IdentityFile 指向你的私钥文件路径。
PreferredAuthentications 指定 SSH 客户端在尝试身份验证时应优先考虑的认证方法列表。例如，你可以设置为只使用公钥认证，或者优先使用公钥认证，然后再尝试其他 (密码) 认证方式。
IdentitiesOnly yes 指示 SSH 只使用 IdentityFile 指定的身份进行认证，这有助于避免 SSH 代理或默认私钥的干扰。

新增 SSH 密钥到平台帐户

配置 ~/.ssh/config 文件完毕后，必须将 SSH 公钥添加到 GitHub、GitLab 和 Gitee，才能为帐户启用 SSH 访问。

相关链接：

新增 SSH 密钥到 GitHub 帐户

将 SSH 密钥添加到您的极狐 GitLab 帐户

添加 SSH 公钥到 Gitee 帐户

测试 SSH 连接

设置 SSH 密钥并将其添加到 GitHub、GitLab 和 Gitee 后，可以测试连接。

测试 SSH 连接之前，应已完成以上所有步骤。

打开终端，输入以下命令：

ssh -T git@github.com          # 测试 Github 的 SSH 连接

ssh -T git@gitlab.example.com  # 测试 Gitlab 的 SSH 连接。注意：要将 gitlab.example.com 替换为你的实例 URL

ssh -T git@gitee.com           # 测试 Gitee 的 SSH 连接

如果这是你第一次连接，你应该会看到类似以下消息，提示你需要验证平台主机的真实性：

> The authenticity of host ' (IP ADDRESS)' can't be established.

> ED25519 key fingerprint is SHA256:+DiY3wvvV6TuJJhbpZisF/zLDA0zPMSvHdkr4UvCOqU.

> Are you sure you want to continue connecting (yes/no)?

输入 yes，然后按 Enter。

> Hi USERNAME! You've successfully authenticated, but GitHub does not

> provide shell access.

添加成功后，就可以使用 SSH 协议访问这些平台了。例如，你可以使用 git clone git@github.com/username/repository.git 来克隆 GitHub 上的仓库，SSH 会根据 ~/.ssh/config 文件中的配置来选择合适的私钥进行身份验证。

相关链接：

测试 Github 的 SSH 连接

测试 Gitlab 的 SSH 连接

测试 Gitee 的 SSH 连接

我们为电脑配置完 SSH 后，接下来为本地 Git 仓库添加多个远程平台的仓库链接。

配置远程仓库

没有 Git 仓库

为 Git 仓库添加多个远程平台的仓库的前提是得有个本地 Git 仓库。如果你还没有，可以用以下命令初始化一个。

cd your_folder

git init --initial-branch=main

已经有 Git 仓库

如果你已经在其中一个平台上有个 Git 仓库，你可以使用以下命令将其克隆到本地。

git clone <远程仓库URL>

然后，cd 到新初始化、或者克隆下来的仓库目录，添加其他平台的远程仓库链接。

查看远程仓库

添加之前，我们先查看一下本地 Git 仓库是否有远程仓库的链接，在终端执行以下命令：

git remote -v

如果刚才是本地新初始化的 Git 仓库，不会有任何信息打印。但是，刚才是从远程平台克隆下来的，就会有以下信息打印。比如，我们是从 Github 克隆的。

origin	git@github.com:liam-i/git-multi-platform-sync.git (fetch)

origin	git@github.com:liam-i/git-multi-platform-sync.git (push)

删除远程仓库

为了明确指向多平台远程仓库，所以我们用以下命令删除不直观的 origin，稍后再添加一个具有明确指向性的别名。

git remote remove origin

添加远程仓库

为了将本地仓库与其他平台的远程仓库关联起来，需要执行以下命令为它们添加别名。

git remote add <别名> <远程仓库URL>

例如，你可以为 GitHub 仓库添加别名 github，为 GitLab 仓库添加别名 gitlab：

git remote add github git@github.com:liam-i/git-multi-platform-sync.git

git remote add gitlab ssh://git@gitlab.com:liam-i/git-multi-platform-sync.git

git remote add gitee git@gitee.com:liam-i/git-multi-platform-sync.git

添加完成后，我们再用 git remote -v 命令查看一下：

$ git remote -v

github	git@github.com:liam-i/git-multi-platform-sync.git (fetch)

github	git@github.com:liam-i/git-multi-platform-sync.git (push)

gitlab	ssh://git@gitlab.com:liam-i/git-multi-platform-sync.git (fetch)

gitlab	ssh://git@gitlab.com:liam-i/git-multi-platform-sync.git (push)

gitee	git@gitee.com:liam-i/git-multi-platform-sync.git (fetch)

gitee	git@gitee.com:liam-i/git-multi-platform-sync.git (push)

同步操作

推送代码

当你对本地仓库进行了修改，并提交了新的更改后，可以使用以下命令将这些更改推送到所有远程平台：

git push <别名> <分支名>

例如，将更改推送到 GitHub、GitLab 和 Gitee：

git push github main

git push gitlab main

git push gitee main

拉取代码

如果你想从某个远程仓库拉取最新的更改到本地，可以使用以下命令：

git pull <别名> <分支名>

例如，从 GitHub、GitLab 和 Gitee 拉取更改：

git pull github main

git pull gitlab main

git pull gitee main

注意：在拉取代码之前，请确保你在正确的分支上，并且本地仓库的工作目录是干净的。

管理与维护

为了保持多个平台上的仓库数据一致性，你需要定期进行同步操作。同时，当在多个平台上进行协作时，注意解决可能出现的冲突。要解决冲突可以使用 git merge 工具，并确保在推送更改之前测试代码的完整性。

关于更详细的 Git 操作指令请参考：

Git 常用命令思维导图

Git 一个先进的分布式版本控制系统

结语

看完这篇博客，你应该已经知道怎么在多个平台上玩转 Git 仓库同步了。同步时别忘了多留个心眼，还要时不时确认下各平台的数据是否都对得上。希望你用 Git 越来越 6！

参考资料

访问博址 liam-i.github.io 获取更佳阅读体验和最新内容。