跳至内容

使用 git CLI 添加远程仓库

简介

本教程说明了如何使用 Git 命令行界面将特定的远程仓库添加到现有本地 FOSS 项目克隆中。我们将以 Rocky Linux 文档项目(https://github.com/rocky-linux/documentation.git)的仓库为例,作为一个 FOSS 项目。

先决条件

  • 一个 GitHub 账户。
  • 系统上安装了 git
  • FOSS 项目仓库的本地克隆。

过程

  1. 打开终端,并将您的工作目录更改为包含项目本地克隆的文件夹。例如,如果您将 github 仓库克隆到 ~/path/to/your/rl-documentation-clone,请键入

    cd ~/path/to/your/rl-documentation-clone
    
  2. 在进行任何更改之前,请列出您已配置的远程仓库。键入

git remote -vv

如果这是一个新克隆的仓库,您很可能会在输出中看到一个名为 origin 的单独远程仓库。

  1. 将 Rocky Linux 文档仓库(https://github.com/rocky-linux/documentation.git)添加为本地仓库的新远程仓库。在这里,我们将为此特定远程仓库分配 upstream 名称。键入

    git remote add upstream https://github.com/rocky-linux/documentation.git
    
  2. 为了进一步强调分配给远程仓库的名称是任意的,请通过运行以下命令创建一个名为 rocky-docs 的另一个远程仓库,该仓库指向相同的仓库

git remote add rocky-docs https://github.com/rocky-linux/documentation.git
  1. 确认新远程仓库已成功添加

    git remote -v
    

    您应该会看到列出的 upstream 及其 URL。

  2. (可选)在您开始对本地仓库进行任何更改之前,您可以从新添加的远程仓库中获取数据。通过运行以下命令从新添加的远程仓库获取分支和提交

    git fetch upstream
    

附加说明

  • Origin:这是 Git 为您克隆的远程仓库指定的默认名称。它就像远程仓库 URL 的一个昵称。当您克隆一个仓库时,此远程仓库会在您的本地 Git 配置中自动设置为“origin”。名称是任意的,但这是惯例。

  • Upstream:当您分叉(fork)一个项目时,这通常指的是原始仓库。在开源项目中,如果您分叉一个仓库以进行更改,您分叉的仓库是您的“origin”,而原始仓库通常被称为“upstream”。名称是任意的,但这是惯例。

Origin 和远程仓库的使用/分配之间的这种细微差别对于通过拉取请求(pull requests)向原始项目贡献代码至关重要。

结论

git CLI 实用程序可以轻松使用描述性名称,并将特定远程仓库添加到 FOSS 项目的本地克隆中。这使您能够有效地与各种远程仓库同步和贡献。

作者:Wale Soyinka

贡献者:Ganna Zhyrnova