GitLab 快捷操作

快捷操作提供基于文本的快捷方式，用于执行 GitLab 中的常见操作。 快捷操作：

• 无需使用用户界面即可执行常见操作。
• 支持处理 issues、merge requests、epics 和 commits。
• 在保存描述或评论时自动运行。
• 响应特定上下文和条件。
• 在单独行输入时支持处理多个命令。

例如，您可以使用快捷操作来：

• 分配用户。
• 添加标签。
• 设置截止日期。
• 更改状态。
• 设置其他属性。

每个命令以正斜杠（/）开头，且必须单独输入一行。 许多快捷操作接受参数，您可以使用引号（"）或特定格式输入参数。

参数

许多快捷操作需要参数。例如，/assign 快捷操作需要用户名。GitLab 在快捷操作中使用 自动补全字符，通过提供可用值列表帮助用户输入参数。

如果手动输入参数，必须用双引号（"）括起来，除非参数仅包含以下字符：

• ASCII 字母
• 数字（0-9）
• 下划线（_）、连字符（-）、问号（?）、点（.）、和号（&）或 at 符号（@）

参数区分大小写。自动补全会自动处理大小写和引号插入。

Issues、合并请求和史诗

以下快捷操作适用于描述、讨论和线程。部分快捷操作可能并非所有订阅层级都可用。

工作项

GitLab 中的工作项包括：

• 任务
• OKR
• 史诗（参见 Issues、合并请求和史诗）

以下快捷操作可在编辑或评论工作项时通过描述字段应用。

提交评论

您可以在评论单个 commit 时使用快捷操作。这些快捷操作仅在提交评论线程中有效，不适用于提交消息或其他 GitLab 上下文。

要在提交评论中使用快捷操作：

1. 通过从提交列表、合并请求或其他提交链接中选择 commit，进入 commit 页面。
2. 在 commit 页面底部的评论框中输入您的快捷操作。
3. 选择 Comment。

以下快捷操作适用于提交评论：

以下是 Git 标签示例：

安全修复后准备发布。
/tag v2.1.1 安全修复补丁发布

此评论创建了一个名为 `v2.1.1` 的 Git 标签，指向 commit，消息为 "安全修复补丁发布"。

## 故障排除

### 快捷操作未执行

如果运行快捷操作但未生效，请检查输入时快捷操作是否出现在自动补全框中。
如果未出现，可能原因包括：

- 与快捷操作相关的功能根据您的订阅层级或组/项目的用户角色不可用。
- 快捷操作的必要条件未满足。
  例如，您在没有标签的 issue 上运行 `/unlabel`。