跳至主要内容

跳过工作流运行

您可以通过在提交消息中包含命令来跳过由 `push` 和 `pull_request` 事件触发的 工作流运行。

注意

如果由于路径过滤分支过滤或提交消息(见下文)导致工作流被跳过,则与该工作流关联的检查将保持“挂起”状态。需要这些检查才能成功的拉取请求将被阻止合并。

如果您在推送的提交消息或拉取请求的 HEAD 提交中添加了以下任何字符串,则原本会使用 `on: push` 或 `on: pull_request` 触发的 工作流将不会被触发

  • [skip ci]
  • [ci skip]
  • [no ci]
  • [skip actions]
  • [actions skip]

或者,您可以在提交消息中添加 `skip-checks` 尾部。尾部部分应包含在提交消息的末尾,并在前面加上两行空行。如果您已经在提交消息中使用了其他尾部,则 `skip-checks` 应放在最后。您可以使用以下任一选项

  • skip-checks:true
  • skip-checks: true

默认情况下,Git 会自动删除连续的新行。要完全按照您输入的方式保留提交消息,请在提交时使用 `--cleanup=verbatim` 选项。有关更多信息,请参阅 Git 文档中的`--cleanup=<mode>`

如果您的仓库配置为首先需要特定检查才能通过,则您将无法合并拉取请求。要允许合并拉取请求,您可以向拉取请求推送新的提交,而提交消息中不包含跳过指令。

注意

跳过指令仅适用于 `push` 和 `pull_request` 事件。例如,在提交消息中添加 `[skip ci]` 不会阻止由 `on: pull_request_target` 触发的 工作流运行。

跳过指令仅适用于由包含跳过指令的提交触发的的工作流运行。您也可以禁用工作流的运行。有关更多信息,请参阅“禁用和启用工作流”。