C++20模块封装spdlog日志库：如何导出format_string_t依赖？

核心问题 #

你的模块接口直接使用了spdlog::format_string_t<Args...>，但该类型的定义未通过模块导出，导致使用者（test.cpp）必须手动包含spdlog头文件才能获取类型定义，违背了模块封装的初衷。

具体解决方案 #

1. 在模块单元中导出spdlog::format_string_t #

在log.ixx模块单元中，先包含定义format_string_t的spdlog头文件，再通过export using导出该类型，让模块使用者仅通过import core.log;就能获取所需定义：

export module core.log;

// 包含定义format_string_t的必要头文件
#include <spdlog/fmt/format.h>
#include <spdlog/common.h>
#include <source_location>

// 导出需要的spdlog类型
export using spdlog::format_string_t;
export using spdlog::level::warn;

// 你的NotFormatString概念定义（示例）
template<typename T>
concept NotFormatString = !std::is_convertible_v<T, spdlog::format_string_t<>>;

// 你的Log基类定义
template<spdlog::level::level_enum Level, typename... Args>
struct Log {
    Log(spdlog::format_string_t<Args...> msg, Args&&... args, std::source_location loc = std::source_location::current()) {
        // 基类实现逻辑
    }
    
    // 针对无格式化参数的重载
    template<typename T>
    Log(T msg, std::source_location loc = std::source_location::current()) {
        // 基类实现逻辑
    }
};

// 你的LogWarn模板定义（保持原有逻辑）
template<NotFormatString... Args>
struct LogWarn : public Log<spdlog::level::warn, Args...> {
    LogWarn(
        spdlog::format_string_t<Args...> message,
        Args&&... args,
        std::source_location source_location = std::source_location::current()) :
        Log<spdlog::level::warn, Args...>(message, std::forward<Args>(args)..., source_location)
    {}
};

template<>
struct LogWarn<> : public Log<spdlog::level::warn> {
    template<typename T>
    LogWarn(T msg, std::source_location source_location = std::source_location::current()) :
        Log<spdlog::level::warn>(msg, source_location)
    {}
};

template<NotFormatString... Args>
LogWarn(spdlog::format_string_t<Args...>, Args&&...) -> LogWarn<Args...>;

template<NotFormatString T>
LogWarn(T) -> LogWarn<>;

2. 确保模块编译时能找到spdlog头文件 #

编译模块时，需将spdlog的头文件路径传递给编译器（例如GCC用-I参数，MSVC用/I参数），确保模块单元能正确包含spdlog的头文件。

3. 验证test.cpp无需包含spdlog头文件 #

修改后的test.cpp可完全移除spdlog头文件包含，仅通过模块导入即可正常编译：

import core.log;

using namespace rain;

int main()
{
    LogWarn("ssss{0}", 1);
    LogWarn("ssss");
    LogWarn(111);

    return 0;
}

关键原理 #

C++20模块允许通过export using将外部头文件中的类型导出到模块接口，模块使用者无需直接包含外部库头文件，仅需导入你的模块就能访问这些类型。同时，模块会将外部类型的定义编译到模块单元中，避免了重复包含头文件的问题。

额外注意事项 #

• 若format_string_t依赖其他spdlog或fmt的类型，需确保这些类型也通过头文件包含间接导出，必要时用export using显式导出。
• 不同编译器对模块的支持存在细节差异，需根据使用的编译器（如GCC、MSVC）调整编译参数。

内容的提问来源于stack exchange，提问作者user10873462