ROS 2 调试信息没出现怎么办：先核对日志级别和输出位置

机器人学习时，节点似乎已经启动，但终端没有出现预期的调试信息。没有看到一行日志，不能马上断定代码没有运行：日志级别、输出位置、节点名称和实际执行路径都可能影响观察结果。下面以 ROS 2 的日志资料为基础，介绍如何在隔离测试环境中整理信息，不把日志当成完整的系统状态证明。

先区分日志内容和日志输出位置

ROS 2 官方日志和记录器配置说明介绍了控制台、磁盘日志文件以及网络上的日志话题等输出目标。文档位于持续开发的 Rolling 分支；实际默认值和可用功能应与所用发行版、客户端库及节点配置核对。

开始排查前，记录节点名称、命名空间、启动方式、ROS 发行版以及预期在哪个位置看到日志。一个程序可能将输出重定向，也可能单独关闭某个日志目标；因此终端没有内容不一定意味着磁盘或其他目标也没有记录。另一方面，有日志输出也不证明机器人任务已经成功。

官方说明列出 DEBUG、INFO、WARN、ERROR 和 FATAL 等级，并介绍记录器按设置的级别过滤消息。学习者可以先核对实际记录器名称和生效级别，再确认预期信息属于什么级别。若节点名称或命名空间被重映射，记录器名称也可能随之变化，排查时应记录运行时名称而不只看源代码。

举一个假设的学习实验：程序包含一条调试级别消息，但当前记录器只处理较高严重程度的消息。此时消息可能被过滤。更改测试配置后，再用相同条件观察，记录配置前后的结果。不要在不了解现场影响时对生产系统大量开启调试输出。

日志说明还描述了名称的层级关系：当某个记录器没有明确设置级别时，可能使用其上级或默认级别。一个进程中可能有多个节点或记录器，改变一个配置不一定等于所有日志都使用同一设置。先确认目标，再记录具体配置和值，避免把不同节点的输出混为一谈。

如果多次运行结果不同，保存启动命令、参数文件和相关环境信息，并说明是否使用了相同工作目录及输出重定向。日志时间戳、节点名称和消息级别有助于复盘，但它们不是对事件因果关系的自动证明；需要结合业务数据和代码执行情况分析。

可以选择不控制真实设备的示例节点，分别在默认配置和明确指定日志级别的配置下运行。ROS 2 的rcutils 官方项目列出了不同级别及一次性输出等日志宏示例。请先确认所用版本和客户端库支持的配置方式，并在测试记录中注明版本和实际命令。

对照时只改变一个已记录的条件，分别保存控制台输出和日志文件位置，检查预期消息是否出现。若依然没有结果，继续核对是否进入了相关代码路径、记录器名称是否匹配以及输出目标是否启用，不应通过猜测直接修改机器人控制逻辑。

日志可能包含设备标识、路径、网络地址或业务内容。向外部求助前，应按照所在团队的要求检查并处理敏感信息，同时保留足以复现问题的版本、时间、级别和上下文。不要把密码或访问令牌复制到公开论坛。

可结合本站运行日志和录制数据的区别及机器人学习资料栏目建立复盘记录。日志是分析的一项线索；实际设备的操作和安全验证仍须遵循现场程序。