使用spdlog和emscripten构建时解决'fmt/bundled/core.h'找不到的问题

问题背景

在使用spdlog日志库与emscripten工具链进行项目构建时，开发者可能会遇到一个常见的编译错误："fatal error: 'spdlog/fmt/bundled/core.h' file not found"。这个问题通常出现在尝试将spdlog与外部fmt库一起使用时，特别是在设置了SPDLOG_FMT_EXTERNAL选项的情况下。

问题分析

spdlog日志库默认会捆绑一个fmt格式化库版本，但开发者也可以选择使用外部安装的fmt库。当启用SPDLOG_FMT_EXTERNAL选项时，spdlog应该使用系统安装的fmt而非其内置版本。然而在实际构建过程中，可能会出现以下情况：

1. 虽然设置了SPDLOG_FMT_EXTERNAL=ON和fmt_DIR，但编译时仍然尝试查找bundled/core.h
2. 在包含spdlog头文件时，SPDLOG_FMT_EXTERNAL宏定义似乎没有被正确继承
3. CMake配置看似正确，但实际编译阶段出现问题

解决方案

正确的CMake配置

确保CMake配置正确是解决问题的第一步。以下是推荐的配置方式：

# 设置spdlog的安装路径
set(spdlog_DIR "/path/to/spdlog/installation")

# 查找spdlog包
find_package(spdlog CONFIG REQUIRED)

# 链接到目标
target_link_libraries(your_target PUBLIC spdlog::spdlog)

关键注意事项

1. spdlog_DIR设置：必须指向包含spdlogConfig.cmake文件的目录，通常是安装路径下的lib/cmake/spdlog/子目录

2. fmt_DIR设置：确保在构建spdlog时正确设置了fmt_DIR，指向外部fmt库的安装位置

3. 宏定义继承：SPDLOG_FMT_EXTERNAL宏应该在spdlog的CMake配置文件中定义，并自动传递给链接目标

常见错误排查

1. 检查spdlog是否确实使用了外部fmt库构建
2. 验证spdlogConfig.cmake文件是否包含正确的宏定义
3. 确保所有相关目标都正确链接了spdlog::spdlog
4. 检查构建日志确认是否使用了预期的库路径

深入理解

spdlog与fmt库的关系是理解这个问题的关键。spdlog内部依赖于fmt库进行实际的格式化操作，提供了两种使用方式：

1. 内置模式：使用spdlog自带的fmt库版本，头文件位于spdlog/fmt/bundled/目录下
2. 外部模式：使用系统安装的fmt库，通过SPDLOG_FMT_EXTERNAL宏切换

当选择外部模式时，spdlog会直接使用系统fmt库的头文件，而不再查找bundled目录下的文件。因此出现"bundled/core.h not found"错误通常意味着虽然设置了外部模式，但实际编译时仍然尝试使用内置模式。

最佳实践

1. 保持spdlog和fmt库版本的兼容性
2. 在项目中使用一致的构建配置
3. 考虑使用包管理器(如vcpkg或conan)来管理依赖关系
4. 对于emscripten构建，确保所有依赖都使用相同的工具链构建

通过正确理解spdlog与fmt库的关系，并遵循上述配置建议，开发者可以避免这类编译错误，成功构建基于spdlog和emscripten的项目。