QT CMake项目中spdlog编译优化实战：从30秒到毫秒级的构建优化

news/2025/12/9 22:21:23/文章来源:https://www.cnblogs.com/tlink/p/19328578

前言

在CMake + Qt项目开发中，我们引入了spdlog作为日志库。起初采用直接包含头文件的方式，但发现每次构建都要额外花费30秒的时间。经过一系列排查和优化，最终将这部分时间降到了毫秒级别。本文将完整记录这个优化过程。

问题现象

项目结构如下：

project/
├── CMakeLists.txt
├── third_party/
│   └── spdlog/          # spdlog头文件
└── src/└── ...              # 项目源码

CMake配置：

target_include_directories(MachineDog PRIVATEthird_party${CURL_INCLUDE_DIR}
)

问题：每次构建时，即使只修改了一个小文件，整个编译过程也要额外花费30秒左右。

初步分析

spdlog是一个功能强大的C++日志库，但它大量使用了模板和头文件内联实现。这导致：

编译膨胀：每个包含spdlog的源文件都要重新解析所有模板代码
重复编译：相同的模板代码在不同编译单元中重复编译
依赖扩散：修改spdlog头文件会导致所有依赖文件重新编译

解决方案探索

方案1：预编译头文件（PCH）

target_precompile_headers(MachineDog PRIVATE<vector><string><memory>third_party/spdlog/spdlog.h
)

效果：有一定改善，但仍不理想，因为spdlog内部还有大量嵌套包含。

方案2：将spdlog作为预编译库

这是最终选择的方案，但实施过程遇到了坑。

实施过程

第一步：编译spdlog静态库

cd third_party/spdlog
mkdir build && cd build
cmake -G "MinGW Makefiles" ..
mingw32-make.exe

得到 libspdlog.a 文件。

第二步：在CMake中配置

初始配置：

set(SPDLOG_LIB_DIR ${CMAKE_CURRENT_SOURCE_DIR}/third_party/spdlog/build)
set(SPDLOG_INCLUDE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/third_party/spdlog/include)add_library(spdlog STATIC IMPORTED)
set_target_properties(spdlog PROPERTIESIMPORTED_LOCATION ${SPDLOG_LIB_DIR}/libspdlog.aINTERFACE_INCLUDE_DIRECTORIES ${SPDLOG_INCLUDE_DIR}
)target_link_libraries(MachineDog PRIVATE spdlog)

问题：构建时间仍然很长，链接还需要9秒！

第三步：关键发现 - SPDLOG_COMPILED_LIB 宏

添加关键配置：

set_target_properties(spdlog PROPERTIESIMPORTED_LOCATION ${SPDLOG_LIB_DIR}/libspdlog.aINTERFACE_INCLUDE_DIRECTORIES ${SPDLOG_INCLUDE_DIR}INTERFACE_COMPILE_DEFINITIONS "SPDLOG_COMPILED_LIB"  # 关键！
)

效果：构建时间从9秒降到毫秒级别！

原理深度解析

spdlog的两种工作模式

1. 头文件模式（默认）

所有实现代码都在头文件中
每个编译单元重复编译相同代码
编译时间长，二进制体积大

2. 编译库模式（SPDLOG_COMPILED_LIB）

实现代码编译到静态库中
头文件只包含声明
编译快，二进制体积小

宏的作用机制

查看spdlog源码：

// spdlog/common.h
#ifdef SPDLOG_COMPILED_LIB// 编译库模式：只声明template<typename... Args>void info(const char* fmt, const Args&... args);
#else// 头文件模式：完整实现template<typename... Args>void info(const char* fmt, const Args&... args) {// 大量模板代码...}
#endif

为什么需要这个宏？

没有宏的情况：
- 即使链接了 libspdlog.a，仍然使用头文件模式
- 静态库可能包含空实现或未被使用
- 编译时间没有优化
有宏的情况：
- 切换到真正的编译库模式
- 头文件只生成声明
- 实现从静态库链接

完整优化配置

最佳实践配置

# 设置路径
set(SPDLOG_ROOT ${CMAKE_CURRENT_SOURCE_DIR}/third_party/spdlog)
set(SPDLOG_LIBRARY ${SPDLOG_ROOT}/build/libspdlog.a)
set(SPDLOG_INCLUDE_DIR ${SPDLOG_ROOT}/include)# 创建导入目标
add_library(spdlog::spdlog STATIC IMPORTED)set_target_properties(spdlog::spdlog PROPERTIESIMPORTED_LOCATION ${SPDLOG_LIBRARY}INTERFACE_INCLUDE_DIRECTORIES ${SPDLOG_INCLUDE_DIR}# 关键定义INTERFACE_COMPILE_DEFINITIONS "SPDLOG_COMPILED_LIB""SPDLOG_NO_EXCEPTIONS"        # 可选优化"SPDLOG_NO_THREAD_ID"         # 可选优化"SPDLOG_FMT_EXTERNAL"         # 使用外部fmt库
)# 链接fmt库（如果需要）
find_package(fmt REQUIRED)
target_link_libraries(spdlog::spdlog INTERFACE fmt::fmt)# 链接到主目标
target_link_libraries(MachineDog PRIVATE spdlog::spdlog)

编译spdlog时的优化配置

# 重新编译spdlog，启用优化
cd third_party/spdlog/build
rm -rf *
cmake -G "MinGW Makefiles" \-DCMAKE_BUILD_TYPE=Release \-DCMAKE_CXX_FLAGS="-O3 -flto -DSPDLOG_COMPILED_LIB" \-DSPDLOG_BUILD_EXAMPLE=OFF \-DSPDLOG_BUILD_TESTS=OFF \-DSPDLOG_BUILD_SHARED=OFF \-DSPDLOG_FMT_EXTERNAL=ON \..
mingw32-make.exe -j8

性能对比

配置方案	编译时间	链接时间	二进制大小	备注
纯头文件	30+秒	快	大	默认情况
预编译头	15秒	快	中	部分优化
静态库(无宏)	30秒	9秒	大	错误配置
静态库(有宏)	快	正常	小	正确配置