更改远程仓库的 URL

git remote set-url 命令使用两个参数：

• 现有远程仓库的名称。 例如，源仓库或上游仓库是两种常见选择。
• 远程仓库的新 URL。 例如：
  • 如果您要更新为使用 HTTPS，您的 URL 可能如下所示：

    https://[hostname]/USERNAME/REPOSITORY.git

  • 如果您要更新为使用 SSH，您的 URL 可能如下所示：

    git@hostname:USERNAME/REPOSITORY.git

将远程 URL 从 SSH 切换到 HTTPS

1. 打开 Terminal（终端）Terminal（终端）Git Bash。
2. 将当前工作目录更改为您的本地仓库。
3. 列出现有远程仓库以获取要更改的远程仓库的名称。

   $ git remote -v
   > origin  git@hostname:USERNAME/REPOSITORY.git (fetch)
   > origin  git@hostname:USERNAME/REPOSITORY.git (push)

4. 使用 git remote set-url 命令将远程的 URL 从 SSH 更改为 HTTPS。

   $ git remote set-url origin https://hostname/USERNAME/REPOSITORY.git

5. 验证远程 URL 是否已更改。

   $ git remote -v
   # Verify new remote URL
   > origin  https://hostname/USERNAME/REPOSITORY.git (fetch)
   > origin  https://hostname/USERNAME/REPOSITORY.git (push)

下次对远程仓库执行 git fetch、git pull 或 git push 操作时，您需要提供 GitHub 用户名和密码。 当 Git 提示您输入密码时，请输入您的个人访问令牌 (PAT)。 基于密码的身份验证对 Git 已弃用，使用 PAT 更安全。 更多信息请参阅“创建个人访问令牌”。

您可以使用凭据小助手让 Git 在每次与 GitHub 会话时记住您的 GitHub 用户名和个人访问令牌。

将远程 URL 从 HTTPS 切换到 SSH

1. 打开 Terminal（终端）Terminal（终端）Git Bash。
2. 将当前工作目录更改为您的本地仓库。
3. 列出现有远程仓库以获取要更改的远程仓库的名称。

   $ git remote -v
   > origin  https://hostname/USERNAME/REPOSITORY.git (fetch)
   > origin  https://hostname/USERNAME/REPOSITORY.git (push)

4. 使用 git remote set-url 命令将远程的 URL 从 HTTPS 更改为 SSH。

   $ git remote set-url origin git@hostname:USERNAME/REPOSITORY.git

5. 验证远程 URL 是否已更改。

   $ git remote -v
   # Verify new remote URL
   > origin  git@hostname:USERNAME/REPOSITORY.git (fetch)
   > origin  git@hostname:USERNAME/REPOSITORY.git (push)

疑难解答

尝试更改远程时可能会遇到这些错误。

No such remote '[name]'

此错误表示您尝试更改的远程不存在：

$ git remote set-url sofake https://hostname/octocat/Spoon-Knife
> fatal: No such remote 'sofake'

检查您是否正确键入了远程仓库的名称。

延伸阅读

• Pro Git 手册中的“处理远程仓库”