ns-3 3.31无日志输出：设置NS_LOG后NS3日志宏仍不显示

已确认的问题表现 #

• 自研ns-3模块运行时无日志输出，替换为官方示例first.cc、third.cc拷贝至scratch目录运行，仍无日志输出
• 全局设置NS_LOG="*"环境变量后运行，输出结果无任何变化
• 代码中通过std::cout、std::clog实现的打印可正常在终端显示，但包含NS_LOG_UNCOND在内的所有ns-3内置日志宏完全不生效
• 问题可在Debian GNU/Linux 10、Ubuntu 20.04系统上稳定复现，使用的ns-3版本为3.31
• 对应命令运行输出截图：

分步修复操作 #

1. 检查编译阶段的日志开关配置 #

ns-3的日志功能是编译期可控的能力，3.31版本如果编译时关闭了日志支持，所有日志宏会被直接编译为空实现，运行时无论怎么设置参数都不会产生输出。

• 进入ns-3 3.31源码根目录，运行./waf --check查看当前编译配置，确认日志构建选项为开启状态
• 若配置中日志支持处于关闭状态，重新执行编译配置：
  运行./waf configure --build-profile=debug --enable-log，开启debug构建模式下的日志能力
• 注意：不要直接使用optimized/Release构建模式运行测试，该模式下ns-3会默认剥离所有日志宏的实现，即使配置了NS_LOG环境变量也不会有任何输出
• 配置完成后重新全量编译：运行./waf build，编译完成后再测试scratch目录下的示例程序

2. 校验NS_LOG环境变量的设置有效性 #

部分场景下环境变量的设置方式存在问题，会导致ns-3进程无法正确解析日志规则：

• 优先采用单命令内联变量的方式运行程序，避免export全局变量时的作用域失效问题，示例写法：
  NS_LOG=* ./waf --run scratch/first
• 避免给NS_LOG的值嵌套多层引号，比如错误写法export NS_LOG="\"*\""会导致ns-3解析组件名失败，直接跳过所有日志输出逻辑

3. 排查代码层面的宏失效问题 #

3.31版本存在编译裁剪特性，部分写法会导致日志宏被直接替换为空：

• 确认代码中所有日志宏的调用位置，都处于#include "ns3/log.h"语句之后，避免在头文件引入前提前调用日志宏导致的宏定义缺失
• 若开发自定义模块，检查模块的waf构建脚本，确认已正确链接ns3-log-3.31核心库，避免日志宏因库链接缺失导致的空实现

4. 排除终端输出缓冲导致的“假无输出” #

如果上述配置都正确，但运行后仍看不到日志，可通过关闭stdout缓冲的方式运行：
stdbuf -o0 ./waf --run scratch/first

内容的提问来源于stack exchange，提问作者Filip Borčík