【问题标题】:How do I interpret and make use of Github commit pages?如何解释和使用 Github 提交页面?
【发布时间】:2014-09-22 00:02:27
【问题描述】:

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

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

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

【问题讨论】:

    标签: git github version-control commit git-commit


    【解决方案1】:

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

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

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

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

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

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

    下图显示了一个单独的插入和一个单独的删除:

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

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

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

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

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

    【讨论】:

      猜你喜欢
      • 2016-05-16
      • 1970-01-01
      • 1970-01-01
      • 2020-06-14
      • 2015-09-12
      • 2021-10-06
      • 2013-06-26
      • 2011-06-27
      • 1970-01-01
      相关资源
      最近更新 更多