如何为开源做贡献:Git入门

来自菜鸟教程
跳转至:导航、​搜索

状态: 已弃用

本文已弃用,不再维护。

原因

我们现在为每个平台单独提供 Git 设置说明。

请参阅

本文可能仍可用作参考,但可能未遵循最佳实践。 我们强烈建议使用更新的文章。


介绍

托管在公共存储库中的开源项目受益于更广泛的开发人员社区所做的贡献,并且通常通过 Git 进行管理。

作为一个分布式版本控制系统,Git 帮助个人和团队为开源软件项目做出贡献和维护。 免费下载和使用,Git 本身就是一个开源项目的例子。

本教程将讨论为开源项目做贡献的好处,并介绍如何安装和设置 Git,以便您可以为软件项目做贡献。

为开源项目做贡献

开源软件是可以免费使用、重新分发和修改的软件。

遵循开源开发模型的项目鼓励通过分布式同行评审推进透明流程。 开源项目可以根据需要快速更新,并提供可靠且灵活的软件,而不是建立在锁定的专有系统上。

为开源项目做出贡献有助于确保它们尽可能好并代表广泛的技术最终用户群。 当最终用户通过代码或 文档 为开源项目做出贡献时,他们的不同观点为项目、项目的最终用户和更大的开发人员社区提供了附加价值。

开始为开源项目做贡献的最佳方式是从为您已经使用的软件做贡献开始。 作为特定工具的用户,您最了解哪些功能对项目最有价值。 确保首先阅读有关该软件的任何可用文档。 其实很多开源项目的根目录下都会有一个CONTRIBUTING.md文件,投稿前要仔细阅读。 如果有可用的项目论坛,您可能还想了解社区中其他开发人员之间的交互。

最后,如果你开始为开源软件做贡献,最好从小事做起——每一个贡献都是有价值的。 您可能希望从修正拼写错误、添加评论或编写更清晰的文档开始。

吉特

最流行的软件版本控制系统之一是 Git。 Git 由 Linux 内核的创建者 Linus Torvalds 于 2005 年创建。 Junio Hamano 最初用于开发 Linux 内核,是该项目的当前维护者。

许多项目将文件保存在 Git 存储库中,GitHub、GitLab 和 Bitbucket 等网站简化了共享和贡献代码的过程。 Git 中的每个工作目录都是一个成熟的存储库,具有完整的历史记录和跟踪,独立于网络访问或中央服务器。

版本控制已成为现代软件开发中不可或缺的工具,因为这些系统允许您在源代码级别跟踪软件。 您和开发团队的其他成员可以跟踪更改、恢复到以前的阶段,并从基本代码分支以创建文件和目录的替代版本。

Git 对于开源项目非常有用,因为它促进了许多开发人员的贡献。 每个贡献者都可以从代码库的主分支或主分支分支出来以隔离他们自己的更改,然后可以发出拉取请求以将这些更改集成到主项目中。

要使用 Git 为开源项目做贡献,让我们检查一下是否安装了 Git,如果没有安装,我们来看看如何在本地机器上安装它。

检查是否安装了 Git

首先,您需要检查您的计算机上是否安装了 Git 命令行工具。 如果您一直在为自己的代码创建存储库,那么您可能已经在本地计算机上安装了 Git。 一些操作系统还安装了 Git,因此在安装之前值得检查。

您可以通过在 Linux 或 Mac 中打开终端窗口或在 Windows 中打开命令提示符窗口并键入以下命令来检查是否安装了 Git 以及您使用的版本:

git --version

但是,如果未安装 Git,您将收到类似于以下内容的错误:

-bash: git: command not found
'git' is not recognized as an internal or external command, operable program, or batch file.

在这种情况下,您应该将 Git 安装到您的机器中。 让我们来看看几个主要操作系统的安装。

在 Linux 上安装 Git

到目前为止,安装 Git 并准备好使用的最简单方法是使用您的 Linux 默认存储库版本。 让我们来看看如何使用这种方法在本地 Linux 机器上安装 Git。

在 Ubuntu 或 Debian 上安装 Git

您可以使用 APT 包管理工具来更新您的本地包索引。 之后,您可以下载并安装该程序:

sudo apt update
sudo apt install git

虽然这是安装 Git 的最快方法,但版本可能比最新版本旧。 如果您需要最新版本,请考虑使用 本指南 从源代码编译 Git。

从这里,您可以继续阅读 设置 Git 部分。

在 CentOS 上安装 Git

我们将使用 CentOS 的本地包管理器 yum 来搜索和安装 CentOS 存储库中可用的最新 Git 包。

让我们首先通过运行以下命令确保 yum 是最新的:

sudo yum -y update

-y 标志用于提醒系统我们知道我们正在进行更改,防止终端提示我们确认。

现在,我们可以继续安装 Git:

sudo yum install git

虽然这是安装 Git 的最快方法,但版本可能比最新版本旧。 如果您需要最新版本,请考虑按照 本指南 中的选项 2 从源代码编译 Git。

从这里,您可以继续阅读 设置 Git 部分。

在 Fedora 上安装 Git

Fedora 的 Git 包可通过 yumdnf 获得。 在 Fedora 18 中引入的 DNF 或 Dandified Yum 自 Fedora 22 以来一直是 Fedora 的默认包管理器。

在终端窗口中,更新 dnf 并安装 Git:

sudo dnf update
sudo dnf install git

如果你有旧版本的 Fedora,你可以使用 yum 命令代替。 我们先更新yum,然后安装Git:

sudo yum update
sudo yum install git

从这里,您可以继续阅读 设置 Git 部分。

在 macOS 上安装 Git

在本地 Macintosh 计算机上,如果您在终端窗口中键入 Git 命令(如上面的 git --version 所示),如果系统上尚未安装 Git,系统会提示您安装 Git。 当您收到此提示时,您应该同意安装 Git 并按照说明操作并响应终端窗口中的提示。

您可以通过二进制安装程序将最新版本的 Git 安装到您的 Mac 上。 维护了一个 OS X Git 安装程序,可通过 Git 网站下载。 点击这里会自动开始下载。

完全安装 Git 后,您可以继续阅读 设置 Git 部分。

在 Windows 上安装 Git

对于 Windows,您可以通过 Git 网站下载官方版本。 点击这里会自动开始下载。

还有一个名为 Git for Windows 的开源项目,它与 Git 官方网站是分开的。 该工具提供命令行和图形用户界面工具,以便在您的 Windows 机器上有效地使用 Git。 有关此项目的更多信息以及检查和下载代码,请访问 Git for Windows 项目站点

完全安装 Git 后,您可以继续阅读 设置 Git 部分。

设置 Git

现在您已经安装了 Git,您需要做一些事情,以便为您生成的提交消息将包含您的正确信息。

最简单的方法是通过 git config 命令。 具体来说,我们需要提供我们的姓名和电子邮件地址,因为 Git 会将这些信息嵌入到我们所做的每个提交中。 我们可以继续并通过键入以下内容添加此信息:

git config --global user.name "Your Name"
git config --global user.email "youremail@domain.com"

我们可以通过键入以下内容来查看已设置的所有配置项:

git config --list

git配置

user.name=Your Name
user.email=youremail@domain.com

您可能会注意到,它的格式略有不同。 信息存储在您的 Git 配置文件中,您可以选择使用文本编辑器手动编辑该文件,例如 nano:

nano ~/.gitconfig

~/.gitconfig 内容

[user]
    name = Your Name
    email = youremail@domain.com

完成文件编辑后,您可以通过键入 control 和 x 键退出 nano,并在提示保存文件时按 y

您可以设置许多其他选项,但这是防止将来出现警告所需的两个基本选项。

结论

在本地计算机上安装和设置 Git 后,您现在可以使用 Git 对自己的软件项目进行版本控制,并为向公众开放的开源项目做出贡献。

将您自己的贡献添加到开源软件是一种更好地参与更广泛的开发人员社区的好方法,并有助于确保为公众制作的软件具有高质量并完全代表最终用户。