构建状态

最后修改日期： 2025年 3月 21日

构建状态图标显示在项目页面上构建配置的展开视图下的每个构建旁边。

停止正在运行的构建将导致构建状态显示为已取消。您可以通过构建结果、构建配置主页或使用停止选项从操作下拉菜单中停止正在运行的构建。

当构建开始时，构建过程会调用运行器进程并侦听其输出。停止" 命令会终止 runner 进程，然后构建过程停止。

note
您可以配置您的构建，使其在构建停止后继续执行构建步骤。为此，可以添加一个选择了 Always, even if build stop command was issued 选项的构建步骤。参见配置构建步骤。

个人构建状态

TeamCity 会将运行时间显著超过预估平均运行时间并且自预估超出以来未发送任何消息的构建视为挂起。

如果有一个已经完成且包含更多更改的构建存在，正在进行的构建可以被标记为已过期。挂起和过期的构建会显示图标。将光标移至图标上方，可以查看一个工具提示，显示有关警告的附加信息。

未能启动的构建，也就是没有达到启动第一个构建步骤的构建，都会用图标标记。可能是由于在构建开始时 VCS 仓库关闭，或者无法解析 artifact 依赖等问题所导致的。这种构建状态通常是配置错误的指示，通常应由构建工程师而非开发人员来解决。
如果发生此类错误，TeamCity：

构建的成功或失败会影响其颜色以及其父配置和项目的颜色。彩色图标提供了构建平台的全局视图，使您能够立即发现有问题的项目。

TeamCity 对象图标有三种不同的颜色：

灰色: 构建：尚未开始（排队中）或已取消。
配置：所选分支没有构建，或者默认分支没有（适用于侧边导航树和 <All branches> 视图）。
项目：项目的配置均没有构建。
绿色: 构建：成功完成或运行中没有任何问题。
配置：所选或默认分支的最后一次构建成功。
项目：其配置的全部为绿色。
红色: 构建：失败或仍在运行但遇到问题。
配置：所选或默认分支的最后一次构建失败。
项目：至少有一个配置为红色。

以下图片说明了相同配置在三个不同分支中的构建情况：“main”（默认分支）、“development”和“sandbox”。

最后一次“development”分支的构建成功。如果选择此分支，配置图标为绿色。
最后一次“sandbox”分支的构建失败。如果选择此分支，配置图标为红色。
默认的“main”分支没有构建，因此侧边导航树和 <All branches> 视图中的配置图标为灰色。同样的“未知”状态适用于整个项目，因为这是其唯一的配置。