跳至内容

使用 Git CLI 添加远程仓库

简介

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

先决条件

  • 一个 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: 这通常指的是您分叉项目时的原始仓库。在开源项目中,如果您分叉了一个仓库以进行更改,分叉的仓库就是您的 “origin”,而原始仓库通常被称为 “upstream”。名称是任意的,但约定俗成。

origin 和远程仓库使用的细微区别对于通过拉取请求为原始项目做出贡献至关重要。

结论

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

作者: Wale Soyinka

贡献者: Ganna Zhyrnova