如何在TeamCity中拆分单个构建步骤的输出日志并标记构建失败

方案1：通过输出TeamCity服务消息标记独立步骤（无需修改CI配置，仅改Python脚本即可） #

TeamCity支持识别标准格式的服务消息，只要在Python脚本中按指定规则打印日志，就能被TeamCity自动识别为独立的块步骤、单独标记任务状态，是成本最低的实现方式。
具体实现规则：

• 每个构建任务启动时，输出 ##teamcity[blockOpened name='构建任务: 对应库/应用名称']
• 任务执行过程中的所有日志会自动归到当前块下，可单独折叠查看
• 任务执行成功时，输出 ##teamcity[blockClosed name='构建任务: 对应库/应用名称'] 关闭块
• 任务执行失败时，先输出 ##teamcity[buildProblem description='任务xxx构建失败: 具体错误信息'] 上报问题，再关闭块，TeamCity会直接标记该任务异常，整体构建状态也会同步为失败，无需翻全量日志就能定位失败任务。

Python实现示例：

import subprocess

def run_single_build(task_name: str, build_command: str) -> bool:
    # 开启TeamCity独立步骤块，flush强制刷新避免日志缓冲导致时序混乱
    print(f"##teamcity[blockOpened name='构建任务: {task_name}']", flush=True)
    try:
        run_result = subprocess.run(
            build_command, 
            shell=True, 
            capture_output=True, 
            text=True, 
            check=True
        )
        print(run_result.stdout)
        # 任务成功关闭块
        print(f"##teamcity[blockClosed name='构建任务: {task_name}']", flush=True)
        return True
    except subprocess.CalledProcessError as e:
        print(e.stdout)
        print(e.stderr)
        # 上报构建问题，标记该任务失败
        print(f"##teamcity[buildProblem description='任务{task_name}构建失败，退出码：{e.returncode}']", flush=True)
        print(f"##teamcity[blockClosed name='构建任务: {task_name}']", flush=True)
        return False

注意必须添加flush=True强制刷新Python的输出缓存，否则服务消息可能延迟输出，导致TeamCity识别时序错误

方案2：调用TeamCity API动态生成原生构建步骤（适合需要完全独立管控的场景） #

如果需要每个构建任务都成为TeamCity原生的独立步骤，支持单独配置重试、超时、权限规则，可以通过TeamCity REST API动态生成步骤：

• 提前把所有要构建的库/应用列表存为配置文件，或者作为构建触发参数传入
• 新增一个前置初始化步骤，调用TeamCity API修改当前构建配置的步骤列表，批量插入所有构建任务的独立步骤
• 配置TeamCity按规则执行后续生成的步骤即可

该方案的优点是每个步骤完全独立，有单独的状态统计、耗时统计、操作入口；缺点是如果有数百个任务，构建配置加载速度会变慢，并发执行需要额外配置TeamCity的并行步骤规则。

补充：失败任务快速定位优化 #

如果不需要拆分独立步骤，仅需要快速识别失败任务，除了上述buildProblem消息外，还可以输出##teamcity[buildStatus text='{build.status.text}, 失败任务: 任务1,任务2']自定义构建结果的状态文本，打开构建详情页就能直接看到失败任务列表，无需翻找日志。

内容的提问来源于stack exchange，提问作者Peter Moore