跳至主要内容

在拉取请求中添加评论

在仓库中打开拉取请求后,协作者或团队成员可以评论两个指定分支之间文件的比较,或对整个项目发表一般性评论。

关于拉取请求评论

您可以在拉取请求的 **讨论** 选项卡中添加评论,以发表一般性评论、问题或赞赏。您也可以建议更改,拉取请求的作者可以直接从您的评论中应用这些更改。

您也可以在拉取请求的 **已更改的文件** 选项卡中,以单独的行或文件评论的形式,或作为拉取请求审查的一部分,对特定文件或文件部分进行评论。添加行或文件评论是讨论实现问题或向作者提供反馈的好方法。有关拉取请求审查的更多信息,请参阅“关于拉取请求审查”。

有关在拉取请求审查中添加行或文件评论的更多信息,请参阅“审查拉取请求中的建议更改”。

注意:如果您通过电子邮件回复拉取请求,您的评论将添加到 **讨论** 选项卡中,并且不会成为拉取请求审查的一部分。

要回复现有的行或文件评论,您需要导航到 **讨论** 选项卡或 **已更改的文件** 选项卡中的评论,并在其下方添加额外的评论。

提示

  • 拉取请求评论支持与 GitHub 上常规评论相同的 格式,例如 @提及、表情符号和引用。
  • 您可以在 **已更改的文件** 选项卡中,对拉取请求中的评论添加反应。

在拉取请求中添加评论

  1. 在您的仓库名称下,点击 拉取请求.

    Screenshot of the main page of a repository. In the horizontal navigation bar, a tab, labeled "Pull requests," is outlined in dark orange.

  2. 在拉取请求列表中,点击您想要留下行级评论的拉取请求。

  3. 在拉取请求中,点击 已更改的文件.

    Screenshot of the tabs for a pull request. The "Files changed" tab is outlined in dark orange.

  4. 将鼠标悬停在您想要添加评论的代码行上,然后点击蓝色评论图标。

    Screenshot of a diff in a pull request. Next to a line number, a blue plus icon is highlighted with an orange outline.

  5. 可选地,您可以在多行上添加评论。您可以点击您想要评论的第一行的行号,然后向下拖动以选择一行范围,然后点击您想要评论的最后一行上的蓝色评论图标。或者,您可以点击您想要评论的第一行旁边的蓝色评论图标,然后向下拖动到您想要评论的最后一行。

  6. 在评论字段中,输入您的评论。

  7. 可选地,要建议对该行或多行进行特定更改,请点击 ,然后编辑建议块中的文本。

    Screenshot of a review comment box. The file diff icon to suggest a specific change is outlined in dark orange.

  8. 要直接评论文件,请在文件右侧点击 并输入您的评论。

    Screenshot of an image file on the "Files changed" page of a pull request. To the right of the image file, a comment icon is highlighted with an orange outline.

  9. 完成后,点击添加单个评论

所有关注该拉取请求或仓库的人都会收到您的评论通知。

解决对话

如果您打开了拉取请求,或者您对打开拉取请求的仓库具有写入权限,则可以解决拉取请求中的对话。

要指示已更改的文件选项卡上的对话已完成,请点击解决对话

整个对话将被折叠并标记为已解决,这使得更容易找到仍然需要解决的对话。

如果评论中的建议超出了您的拉取请求的范围,您可以打开一个新的问题来跟踪反馈并链接回原始评论。有关更多信息,请参阅“创建问题”。

发现和导航对话

您可以使用已更改的文件选项卡顶部显示的对话菜单,发现并导航到拉取请求中的所有对话。

从这个视图中,您可以看到哪些对话未解决、已解决和已过时。这使得发现和解决对话变得容易。

Screenshot of the "Conversations" menu on the "Files Changed" tab of a pull request.

进一步阅读