如何完整迁移 Git 仓库 ?

wptr33 2025-05-15 21:29 20 浏览

Git 已经成为软件开发中版本控制和协作的事实上的标准。有时，开发人员可能需要将整个 Git 存储库 (包括其历史记录、分支和标记) 移动到新的位置或托管服务。在这个全面的指南中，我们将讨论在不丢失任何关键数据或历史记录的情况下无缝地重新定位完整 Git 存储库的过程。

(1) 准备工作

在开始移动之前，请确保拥有存储库的备份，并且所有本地更改都已提交并推送到当前远程。此步骤将防止在转换过程中丢失任何数据。

首先，使用 git clone 命令将存储库克隆到本地机器上。该命令将创建一个带有存储库名称的新目录，其中包含整个 Git 存储库的副本，包括所有分支、标签和提交历史。

git clone https://old-remote-url.com/your-repo.git

切换到新创建的存储库目录，接下来，使用 git remote add 命令添加新的远程存储库关联。

cd your-repo 
git remote add new-origin https://new-remote-url.com/your-repo.git

使用带有 --al 和 --tags 选项的 git push 命令将所有分支、标签推送到新的远程存储库。

git push new-origin --all 
git push new-origin --tags

更新本地存储库，以使用新的远程作为其默认源。使用 git remote remove 命令删除旧的远程，并使用 git remote rename 命令将新远程重命名为 origin。

git remote remove origin 
git remote rename new-origin origin

如果存储库包含子模块，还需要更新它们的远程地址。对于每个子模块，切换到其目录并按照步骤 3-5 添加新的远程、推送更改和更新本地引用。

通知所有协作者存储库的重新定位，并向他们提供新的远程 URL。他们需要通过重新克隆存储库或使用 git remote set-url 命令更改远程 URL 来更新本地存储库。

git remote set-url origin https://new-remote-url.com/your-repo.git

git add .