基于Spdlog + Qt的日志显示框架设计与实现

基于Spdlog + Qt的日志显示框架设计与实现——让日志系统成为CAE软件的“黑匣子”，轻松集成、跨模块共享、界面实时显示

在CAE软件开发中，日志系统是不可或缺的基础设施。无论是求解器迭代过程、网格生成状态，还是错误诊断信息，都需要一个高效、易用、美观的日志输出方案。本文将分享一个基于Spdlog（C++高性能日志库）和Qt（跨平台界面库）的日志显示框架，让你能在软件内部实现一个实时滚动的彩色控制台，并且所有模块（EXE/DLL）只需一行代码即可输出日志。

一、为什么选择Spdlog + Qt？

- Spdlog：纯头文件（也可编译为库），支持异步、多线程、多种sink（控制台、文件、自定义），性能极高，采用MIT许可证可商用。

- Qt：提供QPlainTextEdit等控件，配合QMetaObject::invokeMethod可实现线程安全的UI更新。

- 组合优势：将Spdlog的qt_sink绑定到界面控件，即可实现跨线程、跨模块的日志显示，无需关心锁和事件传递。

二、框架设计目标

1. 封装成单例DLL：整个进程只维护一个日志界面和Logger实例，所有模块（35个项目）共享。

2. 简单易用：其他模块只需包含一个头文件，调用LogInfo("...")等宏即可。

3. 彩色输出：不同级别（INFO/WARN/ERROR）显示不同颜色。

4. 多输出目标：界面显示 + 控制台输出 + 文件落盘。

5. 线程安全：求解器等后台线程可随意调用日志函数。

三、核心实现步骤

1. 自定义Qt Sink（带颜色）

2. DLL导出接口（C风格）

为便于跨模块调用，我们采用纯C接口，避免C++名称修饰问题。

实现时使用单例模式：

3. 主程序绑定控件

在主窗口的构造函数中，将UI设计器里的QPlainTextEdit传给DLL：

4. 其他模块调用

其他项目只需包含.h并链接.lib，即可任意使用：

四、关键技术点

1. 线程安全

QtColorSink中的QMetaObject::invokeMethod会将更新UI的操作投递到主线程事件队列，因此后台线程直接调用LogInfo是安全的，无需额外加锁。

2. 跨模块共享单例

将整个日志系统放在一个独立的DLL中，所有模块都动态链接这个DLL，从而保证全局只有一个g_logger实例。注意主程序必须最先调用InitLogConsole。

3. 格式化字符串注意事项

- 输出百分号%需写为%%。

- 传入QString需用qPrintable()或toUtf8().constData()转换。

- bool值若要输出true/false，应使用三元表达式：flag ? "true" : "false"。

4. 性能优化

如果日志量极大（每秒上万条），建议启用Spdlog的异步模式，并将界面sink的刷新频率降低。但一般CAE软件迭代步数有限，同步模式已足够。

五、效果展示

5.1 要素提示

集成该框架后，运行程序时界面底部会显示一个彩色控制台，所有模块的日志实时滚动：

- [INFO] 普通消息为黑色

- [WARN] 警告为橙色

- [ERROR] 错误为红色

同时日志自动保存到logs/cae.log文件，便于事后分析。

5.2 集成效果(以读取一个stp几何模型为例)

进度条与日志显示同步效果如图所示。

模型加载结束，日志显示效果

六、总结

通过将Spdlog和Qt封装成一个单例DLL，我们实现了：

- 低耦合：其他项目完全无需知道Qt或Spdlog的存在。

- 高复用：一个DLL服务整个解决方案。

- 线程安全：后台线程随意打印日志。

- 界面友好：彩色显示，自动滚动。

这套框架能极大提升了开发和调试效率。如果你也在开发需要日志界面的桌面软件，不妨一试。

扩展建议：可以进一步增加日志级别动态过滤、清空控制台、导出会话日志等接口。