教程：更新 Git 远程 URL - GitLab

Tier: 基础版，专业版，旗舰版

Offering: JihuLab.com，私有化部署

如果符合以下条件，请更新您的 Git 远程 URL：

如果您没有来自旧远程的现有本地工作副本，则不需要本教程。您可以改为从新的极狐GitLab URL 克隆项目。

本教程解释了如何更新本地仓库的远程 URL，同时避免：

本教程使用 git-remote 命令来管理远程及跟踪仓库。

要更新 Git 远程 URL：

准备工作#

您必须具备：

一个带有 Git 仓库和新极狐GitLab URL 的极狐GitLab 项目。
您要迁移到新极狐GitLab URL 的项目的克隆本地工作副本。
本地机器上已安装 Git。
访问本地机器的命令行界面（CLI）。在 macOS 中，您可以使用 Terminal。在 Windows 中，您可以使用 PowerShell。Linux 用户可能已经熟悉其系统的 CLI。
用于极狐GitLab 的身份验证凭证：
- 您必须通过极狐GitLab 进行身份验证才能更新 Git 远程 URL。如果您的极狐GitLab 账户使用基本用户名和密码身份验证，您必须禁用双重身份验证（2FA）才能从 CLI 进行身份验证。或者，您可以使用 SSH 密钥向极狐GitLab 进行身份验证。

要更新 Git 远程 URL，请确定仓库的现有 URL 和新 URL：

打开终端或命令提示符。
转到本地仓库工作副本。要更改目录，请使用 cd：
```
shell
cd <repository-name>
```
每个仓库都有一个名为 origin 的默认远程。要查看远程仓库的当前远程 fetch 和 push URL，请运行：
```
shell
git remote -v
```
复制并记录返回的 URL。它们通常相同。
获取新 URL：
1. 转到极狐GitLab。
2. 在顶部栏中，选择 搜索或跳转到 并找到您的项目。
3. 在左侧边栏中，选择代码 > 代码仓，以转到项目的 代码仓 页面。
4. 在右上角，选择代码。
5. 根据您用于 git 进行身份验证和克隆的方法，复制 HTTPS 或 SSH URL。如果不确定，请使用与上一步中 origin URL 相同的方法。
6. 记录复制的 URL。

要更新 Git 远程 URL：

打开终端或命令提示符。
转到本地仓库工作副本。要更改目录，请使用 cd：
```
shell
cd <repository-name>
```
更新远程 URL，将 <new_url> 替换为您复制的新仓库 URL：
```
shell
git remote set-url origin <new_url>
```
验证远程 URL 更新是否成功。以下命令显示用于 fetch 和 push 操作的新 URL，列出本地分支，并确认它们正被跟踪到极狐GitLab：
```
shell
git remote show origin
```
- 如果更新失败，请返回上一步，确保您有正确的 <new_url>，然后重试。

要更新多个仓库的远程 URL：

使用 git remote set-url 命令。将 origin 替换为您要更新的远程名称。例如：
```
shell
git remote set-url <remote_name> <new_url>
```
验证每个远程 URL 更新：
```
shell
git remote show <remote_name>
```

更新远程 URL 后，您可以继续像往常一样使用 Git 命令。您的下一个 git fetch、git pull 或 git push 将使用来自极狐GitLab 的新 URL。

恭喜，您已成功更新仓库的远程 URL。

您的项目可能拥有多个远程位置。例如，您有一个从 GitHub 上托管的项目复刻的仓库，但您希望在向 GitHub 发出拉取请求之前在极狐GitLab 中处理您的复刻。

除了更新原始远程 URL 之外，要保留原始远程 URL，并同时维护新旧远程 URL，您可以添加一个新的远程，而不是修改现有的远程。

通过这种方法，您可以逐步过渡到新 URL，同时仍能访问原始仓库。

要添加新的远程 URL：

打开终端或命令提示符。
转到您的本地仓库工作副本。
添加一个新的远程 URL。将 <new_remote_name> 替换为新远程的名称，例如 new-origin，并将 <new_url> 替换为新仓库 URL：
```
shell
git remote add <new_remote_name> <new_url>
```
验证新的远程是否已添加：
```
shell
git remote -v
```

现在，您可以同时使用原始和新远程。例如：