SPDLOG日志库中自定义日志器无法显示函数名的问题解析

在使用SPDLOG日志库时，开发者经常会遇到自定义日志器无法显示函数名、文件名和行号的问题，而默认日志器却能正常显示这些信息。本文将深入分析这一现象的原因，并提供解决方案。

问题现象

当开发者创建自定义日志器时，即使设置了包含%s(文件名)、%#(行号)和%!(函数名)的日志格式模式，这些信息仍然无法显示。而使用默认日志器时，这些调试信息却能正常输出。

根本原因

这个问题的核心在于SPDLOG的设计机制：

1. 宏与函数调用的区别：SPDLOG提供的SPDLOG_INFO等宏会在编译时自动捕获__FILE__、__LINE__和__func__等宏信息，并将这些信息传递给日志记录函数。

2. 直接调用日志函数：当开发者直接调用logger->info()等成员函数时，这些调试信息不会被自动捕获，因为C++标准没有提供在运行时获取这些信息的机制。

解决方案

对于自定义日志器，正确的做法是使用SPDLOG提供的特定宏：

1. 使用SPDLOG_LOGGER_LEVEL宏：对于自定义日志器，应该使用SPDLOG_LOGGER_INFO、SPDLOG_LOGGER_DEBUG等宏，这些宏会正确捕获源代码位置信息。

2. 示例代码：

std::shared_ptr<spdlog::logger> custom_logger = get_custom_logger();
SPDLOG_LOGGER_INFO(custom_logger, "这是一条带有源代码位置信息的日志");

深入理解

1. 宏展开机制：SPDLOG的日志宏实际上会展开为包含__FILE__、__LINE__等信息的调用，这些信息在预处理阶段就被确定。

2. 性能考虑：直接调用成员函数虽然更高效，但牺牲了调试信息的便利性。SPDLOG通过提供不同的接口来让开发者根据场景选择。

3. 版本兼容性：需要注意的是，SPDLOG的最新稳定版本是1.x系列，虽然代码中可能显示2.0.0，但这是开发分支的版本号。

最佳实践

1. 对于需要调试信息的场景，始终使用SPDLOG提供的宏
2. 对于性能敏感且不需要调试信息的场景，可以考虑直接调用成员函数
3. 保持SPDLOG库的更新，以获取最佳的功能和性能

通过理解SPDLOG的这一设计特点，开发者可以更有效地利用这个强大的日志库，在需要时获取完整的调试信息，在性能敏感时又能进行优化。