评论与线程

极狐GitLab 鼓励通过评论、线程和建议代码更改进行交流。评论支持 Markdown 和 快速动作。

有两种类型的评论可用：

• 标准评论。
• 线程中的评论，可以解决。

您可以在提交差异评论中建议代码更改，用户可以通过用户界面接受。

您可以添加评论的地方#

您可以在以下地方创建评论：

• 提交差异。
• 提交。
• 设计。
• 史诗。
• 议题。
• 合并请求。
• 代码片段。
• 任务。
• OKRs。
• Wiki 页面。

每个对象最多可以有 5,000 条评论。

提及#

您可以在您的极狐GitLab 实例中通过 @用户名 或 @群组名 提及用户或群组（包括子群组）。极狐GitLab 会通过待办事项和电子邮件通知所有提到的用户。用户可以在通知设置中自行更改此设置。

您可以快速看到哪些评论涉及到您，因为极狐GitLab 会以不同的颜色突出显示对您自己的提及（当前已认证用户）。

提及所有成员#

避免在评论和描述中提及 @all。@all 不仅会提及项目、议题或合并请求的参与者，还会提及该项目的父群组的所有成员。所有这些用户都会收到电子邮件通知和待办事项，并可能将其视为垃圾邮件。

启用此功能标志后，在评论和描述中输入 @all 将显示为纯文本，而不是提及所有用户。禁用此功能后，Markdown 文本中的现有 @all 提及不会改变，仍然是链接。只有未来的 @all 提及会显示为纯文本。

可以在群组的设置中禁用通知和提及。

在议题或合并请求中提及群组#

当您在评论中提及群组时，群组的每个成员都会获得一个待办事项添加到他们的待办列表中。

1. 在左侧边栏中，选择 搜索或转到 并找到您的项目。
2. 对于合并请求，选择 代码 > 合并请求，并找到您的合并请求。
3. 对于议题，选择 计划 > 议题，并找到您的议题。
4. 在评论中，键入 @ 后跟用户、群组或子群组命名空间。例如，@alex，@alex-team 或 @alex-team/marketing。
5. 选择 评论。

极狐GitLab 为所有群组和子群组成员创建了待办事项。

有关提及子群组的更多信息，请参见提及子群组。

向合并请求差异添加评论#

当您向合并请求差异添加评论时，即使您：

• 在重新基准后强制推送。
• 修改提交。

评论仍然会保留。

要添加提交差异评论：

1. 在左侧边栏中，选择 搜索或转到 并找到您的项目。
2. 选择 代码 > 合并请求，并找到您的合并请求。
3. 选择 提交 选项卡，然后选择提交消息。
4. 在您想评论的行旁边，悬停在行号上并选择 评论 (
   )。您可以通过拖动 评论 (
   ) 图标选择多行。
5. 输入您的评论。
6. 要立即添加您的评论，请选择 立即添加评论，或使用键盘快捷键：
   • macOS：Shift + Command + Enter
   • 所有其他操作系统：Shift + Control + Enter
7. 要在完成审查之前将您的评论留为未发布，请选择 开始审查，或使用键盘快捷键：
   • macOS：Command + Enter
   • 所有其他操作系统：Control + Enter

评论显示在合并请求的 概览 选项卡上。

评论不会显示在您的项目的 代码 > 提交 页面上。

通过发送电子邮件回复评论#

如果您已经配置了"通过电子邮件回复"，您可以通过发送电子邮件来回复评论。

• 当您回复标准评论时，它会创建另一个标准评论。
• 当您回复线程评论时，它会在线程中创建回复。
• 当您发送电子邮件到议题电子邮件地址时，它会创建标准评论。

您可以在电子邮件回复中使用 Markdown 和 快速动作。

编辑评论#

您可以随时编辑自己的评论。拥有至少 管理员 角色的任何人也可以编辑其他人发表的评论。

要编辑评论：

1. 在评论中选择 编辑评论 (
   )。
2. 进行编辑。
3. 选择 保存更改。

编辑评论以添加提及#

默认情况下，当您提及用户时，极狐GitLab 为他们创建待办事项，并向他们发送通知电子邮件。

如果您编辑现有评论以添加之前不存在的用户提及，极狐GitLab：

• 为提及的用户创建待办事项。
• 不发送通知电子邮件。

通过锁定讨论来防止评论#

您可以在议题或合并请求中防止公开评论。当您这样做时，只有项目成员可以添加和编辑评论。

前提条件：

• 在合并请求中，您必须至少具有开发者角色。
• 在议题中，您必须至少具有报告者角色。

要锁定议题或合并请求：

1. 在左侧边栏中，选择 搜索或转到 并找到您的项目。
2. 对于合并请求，选择 代码 > 合并请求，并找到您的合并请求。
3. 对于议题，选择 计划 > 议题，并找到您的议题。
4. 在右上角，选择 合并请求操作 或 议题操作 (
   )，然后选择 锁定讨论。

极狐GitLab 会将系统备注添加到页面详情中。

您必须在重新打开议题或合并请求之前解锁关闭议题或合并请求中的所有锁定讨论。

添加内部备注#

使用内部备注来保护添加到 公共 议题、史诗或合并请求中的信息。内部备注与公开评论不同：

• 只有项目成员至少具有报告者角色才能查看内部备注。
• 您不能将内部备注转换为常规评论。
• 所有对内部备注的回复也都是内部的。
• 内部备注显示 内部备注 徽章，并以不同颜色显示于公开评论：

前提条件：

• 您必须至少具有项目的报告者角色。

要添加内部备注：

1. 在议题、史诗或合并请求中，在 评论 文本框中输入评论。
2. 在评论下方选择 将此作为内部备注。
3. 选择 添加内部备注。

您还可以标记整个议题为机密，或创建机密合并请求。

仅显示评论#

在有许多评论的讨论中，过滤讨论以仅显示评论或更改历史（系统备注）。系统备注包括对描述的更改、在其他极狐GitLab 对象中的提及，或对标签、指派和里程碑的更改。极狐GitLab 会保存您的偏好，并将其应用于您查看的每个议题、合并请求或史诗。

1. 在合并请求、议题或史诗上选择 概览 选项卡。
2. 在页面右侧，从 排序或过滤 下拉列表中选择过滤器：
   • 显示所有活动：显示所有用户评论和系统备注。
   • 仅显示评论：仅显示用户评论。
   • 仅显示历史记录：仅显示活动备注。

更改活动排序顺序#

反转默认顺序并与按最新项目排序的活动提要进行交互，最新项目位于顶部。极狐GitLab 会将您的偏好保存在本地存储中，并将其应用于您查看的每个议题、合并请求或史诗。

要更改活动排序顺序：

1. 在合并请求、议题或史诗中打开 概览 选项卡。
2. 在页面右侧，从 排序或过滤 下拉列表中选择排序顺序 最新优先 或 最旧优先（默认）。

查看描述更改历史记录#

您可以看到历史记录中列出的描述更改。

要比较更改，选择 与上一版本比较。

将议题分配给评论用户#

您可以将议题分配给发表评论的用户。

1. 在评论中，选择 更多操作 (
   ) 菜单。
2. 选择 分配给评论用户：
3. 要取消分配评论者，请再次选择该按钮。

通过回复标准评论创建线程#

当您回复标准评论时，您会创建一个线程。

前提条件：

• 您必须至少具有访客角色。
• 您必须在议题、合并请求或史诗中。提交和代码片段中的线程不受支持。

要通过回复评论创建线程：

1. 在评论的右上角，选择 回复评论 (
   ) 以显示回复部分。
2. 输入您的回复。
3. 选择 回复 或 立即添加评论（取决于您在 UI 中回复的位置）。

极狐GitLab 将顶部评论转换为线程。

不回复评论而创建线程#

您可以在不回复标准评论的情况下创建线程。

前提条件：

• 您必须至少具有访客角色。
• 您必须在议题、合并请求、提交或代码片段中。

要创建线程：

1. 输入评论。
2. 在评论下方，在 评论 的右侧选择向下箭头 (
   )。
3. 从列表中选择 开始线程。
4. 再次选择 开始线程。

解决线程#

当您想结束对话时，可以解决线程。

前提条件：

• 您必须在史诗、议题、任务、目标、关键结果或合并请求中。对于史诗，启用史诗的新外观。
• 您必须至少具有开发者角色或是议题或合并请求的作者。

要解决线程：

1. 转到线程。
2. 执行以下操作之一：
   • 在原始评论的右上角，选择 解决线程 (
     )。
   • 在最后一条回复的 回复 字段中选择 解决线程。
   • 在最后一条回复的 回复 字段中输入文本，选择 解决线程 复选框，然后选择 立即添加评论。

此外，在合并请求中，您可以对线程进行更多操作，例如：

• 将未解决的线程移到新议题。
• 防止合并，直到所有线程都解决。