管理远程仓库

了解如何在计算机上使用本地仓库和托管在 GitHub 上的远程仓库。

平台导航

本文内容

添加远程仓库

若要添加新的远程仓库，请在终端中使用 git remote add 命令，该命令位于存储仓库的目录中。

git remote add 命令采用两个参数

  • 远程名称，例如 origin
  • 远程 URL，例如 https://github.com/OWNER/REPOSITORY.git

例如

$ git remote add origin https://github.com/OWNER/REPOSITORY.git
# Set a new remote

$ git remote -v
# Verify new remote
> origin  https://github.com/OWNER/REPOSITORY.git (fetch)
> origin  https://github.com/OWNER/REPOSITORY.git (push)

有关要使用哪个 URL 的更多信息，请参阅“关于远程仓库”。

故障排除：远程源已存在

此错误表示您已尝试添加一个名称在本地仓库中已存在的远程仓库。

$ git remote add origin https://github.com/octocat/Spoon-Knife.git
> fatal: remote origin already exists.

要解决此问题，您可以

  • 为新远程仓库使用不同的名称。
  • 在添加新远程仓库之前重命名现有的远程仓库。有关更多信息，请参阅下面的“重命名远程仓库”。
  • 在添加新远程仓库之前删除现有的远程仓库。有关更多信息，请参阅下面的“移除远程仓库”。

更改远程仓库的 URL

git remote set-url 命令更改现有的远程仓库 URL。

提示：有关 HTTPS 和 SSH URL 之间差异的信息，请参阅“关于远程仓库”。

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

  • 现有的远程名称。例如，origin 或 upstream 是两个常见选项。

  • 远程仓库的新 URL。例如

    • 如果您正在更新为使用 HTTPS，您的 URL 可能如下所示
    https://github.com/OWNER/REPOSITORY.git
    • 如果您正在更新为使用 SSH，您的 URL 可能如下所示
    [email protected]:OWNER/REPOSITORY.git

将远程 URL 从 SSH 切换到 HTTPS

  1. 打开 终端终端Git Bash。

  2. 将当前工作目录更改为本地项目。

  3. 列出现有远程，以便获取要更改的远程名称。

    $ git remote -v
> origin  [email protected]:OWNER/REPOSITORY.git (fetch)
> origin  [email protected]:OWNER/REPOSITORY.git (push)

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

    git remote set-url origin https://github.com/OWNER/REPOSITORY.git

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

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

下次向远程仓库 git fetch、git pull 或 git push 时，系统会要求你输入 GitHub 用户名和密码。当 Git 提示你输入密码时，输入你的个人访问令牌。或者，你可以使用凭据帮助程序，如 Git Credential Manager。基于密码的 Git 身份验证已被更安全的身份验证方法所取代。有关详细信息，请参阅“管理个人访问令牌”。

你可以 使用凭据帮助程序，这样 Git 每次与 GitHub 通信时都会记住你的 GitHub 用户名和个人访问令牌。

将远程 URL 从 HTTPS 切换到 SSH

  1. 打开 终端终端Git Bash。

  2. 将当前工作目录更改为本地项目。

  3. 列出现有远程，以便获取要更改的远程名称。

    $ git remote -v
> origin  https://github.com/OWNER/REPOSITORY.git (fetch)
> origin  https://github.com/OWNER/REPOSITORY.git (push)

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

    git remote set-url origin [email protected]:OWNER/REPOSITORY.git

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

    $ git remote -v
# Verify new remote URL
> origin  [email protected]:OWNER/REPOSITORY.git (fetch)
> origin  [email protected]:OWNER/REPOSITORY.git (push)

故障排除：没有此类远程“ [名称] ”

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

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

检查你是否正确输入了远程名称。

重命名远程仓库

使用 git remote rename 命令重命名现有远程。

git remote rename 命令接受两个参数

  • 现有远程名称，例如 origin
  • 远程的新名称，例如 destination

重命名远程仓库的示例

这些示例假设你正在 使用 HTTPS 克隆，这是推荐的方法。

$ git remote -v
# View existing remotes
> origin  https://github.com/OWNER/REPOSITORY.git (fetch)
> origin  https://github.com/OWNER/REPOSITORY.git (push)

$ git remote rename origin destination
# Change remote name from 'origin' to 'destination'

$ git remote -v
# Verify remote's new name
> destination  https://github.com/OWNER/REPOSITORY.git (fetch)
> destination  https://github.com/OWNER/REPOSITORY.git (push)

故障排除：无法将配置部分“remote.[旧名称]”重命名为“remote.[新名称]”

此错误表示你输入的旧远程名称不存在。

你可以使用 git remote -v 命令检查当前存在的远程。

$ git remote -v
# View existing remotes
> origin  https://github.com/OWNER/REPOSITORY.git (fetch)
> origin  https://github.com/OWNER/REPOSITORY.git (push)

故障排除：远程 [新名称] 已存在

此错误表示你想要使用的远程名称已存在。要解决此问题，请使用不同的远程名称，或重命名原始远程。

移除远程仓库

使用 git remote rm 命令从仓库中移除远程 URL。

git remote rm 命令接受一个参数

  • 远程名称，例如 destination

从仓库中移除远程 URL 仅取消本地和远程仓库的链接。它不会删除远程仓库。

移除远程仓库的示例

这些示例假设你正在 使用 HTTPS 克隆，这是推荐的方法。

$ git remote -v
# View current remotes
> origin  https://github.com/OWNER/REPOSITORY.git (fetch)
> origin  https://github.com/OWNER/REPOSITORY.git (push)
> destination  https://github.com/FORKER/REPOSITORY.git (fetch)
> destination  https://github.com/FORKER/REPOSITORY.git (push)

$ git remote rm destination
# Remove remote
$ git remote -v
# Verify it's gone
> origin  https://github.com/OWNER/REPOSITORY.git (fetch)
> origin  https://github.com/OWNER/REPOSITORY.git (push)

注意：git remote rm 不会从服务器中删除远程仓库。它只是从本地仓库中移除远程及其引用。

故障排除：无法移除配置部分“remote.[name]”

此错误表示你尝试删除的远程不存在

$ git remote rm sofake
> error: Could not remove config section 'remote.sofake'

检查你是否正确输入了远程名称。

进一步阅读