提交

提交记录并发送源代码变更到仓库

使用命令行提交变更

当你使用命令行时,使用 git commit。你可以添加多个提交,然后推送你的更改。

  • 提交信息:

    提交信息能够识别变更了什么以及为什么变更。使用描述性的消息来澄清变更。在极狐GitLab 中,您可以在提交消息中添加关键字,以执行以下操作:

    • 触发一个极狐GitLab CI/CD 流水线:

      如果项目配置了极狐GitLab CI/CD,那么你应该在每次推送的时候触发流水线而不是每次提交的时候触发。

    • 跳过流水线:

      在你的提交信息中添加 ci skip 关键字来跳过流水线。

    • 交叉链接议题和合并请求:

      使用交叉链接来跟踪您的工作流程中的相关部分。如果在提交消息中提到一个议题或合并请求,它们会在各自的线程中显示。

  • Cherry-pick 提交:

    在极狐GitLab 中,你可以在 UI 上 cherry-pick 提交

  • 还原提交:

    从 UI 上还原提交到一个选择的分支。

  • 签名提交:

    通过签名提交来增加额外的安全。

更多详情,可以查阅阶段、提交和推送变更

合并请求提交

每一个合并请求在被创建后都有针对源分支的提交历史。

这些提交会展示在合并请求的 提交 选项卡中。从此选项卡中,你可以审核提交信息并在需要 cherry-pick 变更的时候拷贝提交的 SHA。

在合并请求中查看提交

要在合并请求中查看提交:

  1. 在左侧导航栏,选择 搜索或前往 并找到你的项目。
  2. 选择 代码 > 合并请求,然后选择你的合并请求。
  3. 要在合并请求中展示提交列表,选择 提交 选项卡。要查阅提交信息,在任意提交上选择 打开提交描述 ( )。
  4. 要查看提交的变更,选择提交标题链接。
  5. 要在合并请求中查看其他提交,您可以:

    • 选择 上一个下一个
    • 使用快捷键:X (上一个提交) 和 C (下一个提交)。

如果你的合并请求构建于之前的合并请求之上,你可能需要包含更多提交

从之前的合并请求中展示提交

当你审核一个合并请求时,你可能需要从之前的提交获取信息来帮助你理解你正在审核的提交。如果其他合并请求是如下情况,则你可能需要更多上下文:

  • 修改了你当前合并请求不修改的文件,所以这些文件不会显示在当前合并请求的差异中。
  • 修改了你当前合并请求修改的文件,你需要看到工作进展。

要添加之前的提交到合并请求中,以便获取更多上下文:

  1. 在左侧导航栏,选择 搜索或前往 并找到你的项目。
  2. 选择 代码 > 合并请求,然后选择你的合并请求。
  3. 选择 提交 选项卡。
  4. 滚动到提交列表的末尾,然后选择 添加之前合并的提交
  5. 选择你想要添加的提交。
  6. 选择 保存更改

API 中,之前被合并的提交被称为 上下文提交

在提交中添加评论

caution 如果提交 ID 在强制推送后发生变化,通过这种方式创建的线程(Threads)会丢失。

要在特定的提交中添加讨论:

  1. 在左侧导航栏,选择 搜索或前往 并找到你的项目。
  2. 选择 代码 > 提交
  3. 在提交下方,在 评论 字段中,输入的评论。
  4. 保存您的评论作为单独的评论,或者作为线程:
    • 要添加评论,选择 评论
    • 要开始线程,选择下拉箭头( ),然后选择 开始线程

查看提交间的差异

要查看质变合并的提交之间的变更:

  1. 在左侧导航栏,选择 搜索或前往 并找到你的项目。
  2. 选择 代码 > 合并请求,然后选择你的合并请求。
  3. 选择 变更
  4. 通过 比较 ( ),选择要比较的提交。

    Previously merged commits

如果您选择添加先前合并的提交以获取上下文,那么这些提交也会显示在列表中。

查找引入变更的合并请求

当您在详情页面上查看提交时,极狐GitLab 会链接到一个或多个包含该提交的合并请求。

此行为仅适用于提交在合并请求的最新版本中。如果提交在合并请求中,然后被重新基于到其他合并请求,提交将不会被链接。