👋 We've unified all of GitHub's product documentation in one place! Check out the content for REST API, GraphQL API, and Developers. Learn more on the GitHub blog.


我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们
文章版本: GitHub.com

关于状态检查

状态检查用于获知您的提交是否符合为您参与的仓库设置的条件。

本文内容

状态检查基于针对您每次向仓库的推送而运行的外部流程,例如持续集成构建。 您可以在拉取请求的个别提交旁边看到状态检查的待处理通过失败状态。

提交和状态列表

对仓库具有写入权限的任何人都可为仓库中的任何状态检查设置状态。

在仓库的分支页面或仓库的拉取请求列表中,可以查看仓库上次提交的整体状态。

如果需要对仓库进行状态检查,必须通过所需的状态检查后,您才可将分支合并到受保护分支。 更多信息请参阅“关于必要的状态检查”。

GitHub 上的状态检查类型

GitHub 上的状态检查有两种类型:

  • 检查
  • 状态

检查状态的不同之处在于它们提供行注解、更详细的信息,并且只适用于 GitHub 应用程序。

组织所有者和能够推送到仓库的用户可使用 GitHub 的 API 创建检查和状态。 For more information, see "Checks" and "Statuses."

检查

在仓库中设置检查时,拉取请求会有一个 Checks(检查)选项卡,从中可以查看状态检查的详细构建输出和重新运行失败的检查。

拉取请求中的状态检查

当提交中的特定行造成检查失败时,您会在拉取请求的 Files(文件)选项卡中相关代码旁边看到有关失败、警告或通知的详细信息。

状态检查详细信息

您可以使用 Conversation(对话)选项卡下的提交下拉菜单,浏览拉取请求中不同提交的检查摘要。

下拉菜单中不同提交的检查摘要

跳过和申请个别提交的检查

当仓库设置为自动申请检查推送时,您可以选择跳过所推送的个别提交的检查。 当仓库设置为自动申请检查推送时,您可以申请检查您推送的个别提交。 For more information on these settings, see "Check Suites."

要跳过或申请检查提交,请在提交消息末添加以下尾行之一:

  • 跳过检查提交,请输入提交消息以及简短、有意义的更改描述。 在提交说明后,不要加上右引号,而是添加两个空行,后接 skip-checks: true
    $ git commit -m "Update README.
    >
    >
    skip-checks: true
    • 申请检查提交,请输入提交消息以及简短、有意义的更改描述。 在提交说明后,不要加上右引号,而是添加两个空行,后接 request-checks: true
      $ git commit -m "Refactor usability tests.
      >
      >
      request-checks: true

问问别人

找不到要找的内容?

联系我们