spdlog 实战：C++ 工业边缘的高性能日志

原创于 2026-08-04 10:51:55 发布 · 380 阅读

2 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

C++ 项目里，日志往往是排障时唯一可靠的线索。spdlog 是目前最主流的 C++ 日志库——header-only、性能高、API 友好。本文用可直接落地的代码，走一遍从安装到异步、多 sink、结构化输出的完整实战。

一、为什么选 spdlog

高性能：格式化基于 fmt，速度快；支持异步模式，业务热路径几乎零阻塞。
易用：header-only，spdlog::info(...) 一行即可用，API 直观。
功能完整：多 sink、按大小/按天滚动、自定义 pattern、结构化输出一应俱全。
生态活跃：社区维护活跃，版本迭代稳定，文档齐全。

二、安装与集成

vcpkg install spdlog

# CMake
find_package(spdlog REQUIRED)
target_link_libraries(myapp PRIVATE spdlog::spdlog)

三、基础用法

#include <spdlog/spdlog.h>

int main() {
    spdlog::info("Hello {}", "world");
    spdlog::warn("warning");
    spdlog::error("error {}", 42);

    spdlog::set_level(spdlog::level::debug); // 默认 info，需显式放开 debug
    spdlog::debug("debug detail");

    return 0;
}

trace / debug / info / warn / error / critical 六个级别，通过 set_level 控制输出下限。

四、格式化输出

spdlog::info("device {} voltage {:.2f}V", "dev_001", 220.5);
spdlog::warn("high latency: {:>5}ms", 1234);
spdlog::error("failed: {} attempts", 3);

// 自定义类型：特化 fmt::formatter
template <>
struct fmt::formatter<Device> {
    constexpr auto parse(format_parse_context& ctx) { return ctx.begin(); }
    template <typename FormatContext>
    auto format(const Device& d, FormatContext& ctx) const {
        return fmt::format_to(ctx.out(), "Device({})", d.id);
    }
};

spdlog 内置了 fmt，直接特化 fmt::formatter 即可让自定义类型参与格式化。若项目额外链接了外部 fmt，注意版本要与 spdlog 自带版本保持一致，否则容易编译冲突。

五、多 sink

一条日志同时写控制台和文件：

#include <spdlog/sinks/stdout_color_sinks.h>
#include <spdlog/sinks/rotating_file_sink.h>
#include <spdlog/sinks/daily_file_sink.h>

auto console = std::make_shared<spdlog::sinks::stdout_color_sink_mt>();
auto file = std::make_shared<spdlog::sinks::rotating_file_sink_mt>(
    "logs/edge.log", 10485760, 5   // 单文件 10MB，最多保留 5 份
);

std::vector<spdlog::sink_ptr> sinks{console, file};
auto logger = std::make_shared<spdlog::logger>("edge", sinks.begin(), sinks.end());
spdlog::register_logger(logger);
spdlog::set_default_logger(logger);

多线程务必用 *_mt 结尾的 sink，*_st 版本非线程安全。

六、异步日志

#include <spdlog/async.h>

spdlog::init_thread_pool(8192, 1); // 队列 8192，1 个后台线程
auto async = spdlog::create_async_nb<spdlog::sinks::rotating_file_sink_mt>(
    "edge_async",
    "logs/edge.log",
    10485760,
    5
);
async->info("async log");
spdlog::flush_every(std::chrono::seconds(3)); // 每 3 秒定时刷盘

create_async_nb（non-blocking）在队列满时会丢弃新日志、不阻塞业务；如果不能丢日志，用 create_async，队列满时会阻塞等待。工业边缘的高频热路径通常选前者。

七、自定义 pattern

spdlog::set_pattern("[%Y-%m-%d %H:%M:%S.%e] [%^%l%$] [%t] [%n] %v");

// JSON 格式，便于日志采集/检索
spdlog::set_pattern(
    R"({"time":"%Y-%m-%dT%H:%M:%S.%e%z","level":"%l","thread":%t,"logger":"%n","msg":"%v"})"
);

%^ %$ 之间是着色区间，%l 级别、%t 线程、%n logger 名、%v 消息体。用 JSON pattern 时注意：消息里若含引号等特殊字符，需要在业务侧自行转义，否则会破坏 JSON。

八、多 logger 管理

按模块（如 Modbus、IEC 104）分别落到独立文件：

class LogManager {
public:
    static void init() {
        auto console = std::make_shared<spdlog::sinks::stdout_color_sink_mt>();

        auto modbus = std::make_shared<spdlog::sinks::rotating_file_sink_mt>(
            "logs/modbus.log", 10485760, 5
        );
        auto modbus_logger = std::make_shared<spdlog::logger>(
            "modbus", spdlog::sinks_init_list{console, modbus}
        );

        auto iec104 = std::make_shared<spdlog::sinks::rotating_file_sink_mt>(
            "logs/iec104.log", 10485760, 5
        );
        auto iec104_logger = std::make_shared<spdlog::logger>(
            "iec104", spdlog::sinks_init_list{console, iec104}
        );

        spdlog::register_logger(modbus_logger);
        spdlog::register_logger(iec104_logger);
    }
};

auto modbus = spdlog::get("modbus");
modbus->info("read holding register");