git - 我如何解释和使用 Github 提交页面？

Question

这是一个非常菜鸟的问题。我在 Github 上找到了一些代码并在我的项目中使用了其中的一部分，后来我发现该代码有问题并在该项目 Github 页面上提交了一个问题，维护者修复了它并且该问题现在有一个指向“提交”页面的链接看起来像这样(来自 this page - 这不是真实的，但很好地说明了问题):

好吧，我想该页面包含我的问题的解决方案，但我对如何解释它一无所知。有很多代码用不同的颜色突出显示，我只是不明白发生了什么。

我如何解释这样的提交页面并使用它？

Answer 1

由于这是一个新手问题，答案将省略您在该页面上看到的核心细节，例如“父提交”和其他在大多数情况下并不重要的内容。所以我们开始...

该页面不显示一些代码，而是显示一些代码是如何更改的。由于您说提交是从您提交的问题中引用的，您可以假设此提交中的更改解决了问题。

提交页面显示了一组更改 - 插入、删除和替换(插入和删除的组合)。以下是您提供的带有注释的图像的一部分:

最上面是文件名。每个更改都发生在某个文件中。文件名是相对于项目根目录的。提交可以包含一个或多个更改，每个更改都属于某个文件，并且将与此上下文信息一起显示。请注意，更改从第 2969 行开始显示 - 这样做是为了简洁，因此您无需滚动到更改。如果您需要查看该代码周围的内容，您可以使用文本扩展按钮。您还可以使用显示特定文件的页面区域右上角某处的“查看”按钮来查看整个文件。

注意优点和缺点。减号表示删除了一些行，加号表示添加了一些行。这里有三个选项 - 仅添加(当在文本的某些位置插入行时)，仅删除(当删除某些行时)和替换，这是它们的组合。

在上图中，您可以看到一个替代品。第 2972​​ 行之前包含一些代码，这些代码已被替换为两行新代码。所以它是删除一行并插入两行。请注意，虽然行号在更改前匹配 - 它们像“2969-2969”、“2970-2970”等，但在更改后它们不再匹配 - 现在它们像“2973-2974”等。这发生了因为将一行替换为两行新行会将代码移动到更改下方，并且更改后的所有行号都将偏移一个。

下图是一个单独的插入和一个单独的删除:

请注意，第 890 行与第 896 行对齐，因为上面的其他更改偏移了文本。如果此更改是文件中的第一个更改，则这些数字将相互匹配。首先是插入——作者决定插入一个带有变量声明的新行，即更改后的第 899 行。然后是删除——作者决定从第 928 行(更改前的编号)中删除带有变量声明的行。在这种特定情况下，两个更改发生在同一个函数中，作者有效地将变量声明从一个地方移到了另一个地方。插入不一定伴随删除，如果有，那么这些删除不一定与此处相关。作者可能找到了一个未使用的变量并只是删除了声明 - 不会插入任何内容。

这就是您在页面上看到的内容。

您应该做什么取决于多种因素。

如果您使用推荐的 Github 流程(这不是绝对必要的，所以不要立即生气)并 fork 项目并编辑 fork ，您可以“merge ”更改 - 这通常可以半完成自动。

但是您的问题暗示您只是下载了代码并在本地进行了编辑。如果是这种情况，您必须在项目中找到相关代码(使用每个更改附近的文件名和函数名)并适当更改您的代码副本。