如何让colcon使用ninja生成器时输出纯CMake项目构建错误信息

Ninja 默认会将构建子进程（编译、链接等执行步骤）的stderr输出重定向到自身的stdout流。colcon 默认的输出处理逻辑会对构建命令的stdout做缓冲、按功能包拆分归类，不会实时透传，仅对stderr流的内容做高优先级直接展示。两者机制叠加后，编译错误、链接错误这类本应走stderr的信息会被colcon缓冲处理，最终导致构建失败时无法正常展示完整错误日志。

以下方案按使用便捷度排序，可根据自身需求选择：

1. 单次构建临时透传全量控制台输出 #

执行构建命令时追加console_direct+事件处理器参数，跳过colcon默认的输出缓冲、分块逻辑，直接把所有构建输出透传到当前终端：

colcon build --event-handlers console_direct+

如果需要查看每个编译、链接步骤的完整执行指令，可额外追加--verbose参数，方便排查底层构建问题。
如果不想看全量构建输出，只需要错误信息，可以把参数替换为console_stderr+，仅透传错误流内容，输出更精简。

2. 配置Ninja保留独立stderr流（适配colcon原生输出格式） #

Ninja 1.10及以上版本提供了--keep-stderr启动参数，可禁止Ninja重定向子进程的stderr流，让colcon正常识别错误流内容，既保留colcon默认的按包整理输出的格式，又能正常展示错误信息。构建时传参方式如下：

colcon build --cmake-args -G Ninja -- --ninja-args --keep-stderr

如果使用的Ninja版本低于1.10，没有该参数，只能选择第一种透传输出的方案，建议升级Ninja版本获得更好的适配效果。

3. 写入全局配置永久生效 #

如果不想每次构建都手动追加参数，可以将配置写入colcon的全局默认配置，对所有工作空间的构建自动生效，不同系统的配置文件路径如下：

• Linux/macOS：~/.colcon/defaults.yaml
• Windows：%APPDATA%\colcon\defaults.yaml

在配置文件中写入以下内容即可：

build:
  event-handlers:
    - console_direct+
  cmake-args:
    - -G
    - Ninja
  ninja-args:
    - --keep-stderr

内容的提问来源于stack exchange，提问作者Roland Sarrazin