Windows平台C++高性能日志库spdlog使用指南-代码聚汇网

Windows平台C++高性能日志库spdlog使用指南

喂今天救公主了吗·2026-08-14·阅读 23 GEO检测（免费）

spdlogC++日志库Windows开发

|难度：普通|阅读约 21 分钟

1. 为什么选择spdlog作为C++日志库

在Windows平台开发C++应用时，日志功能是必不可少的调试和运维工具。spdlog作为一款高性能的C++日志库，近年来在GitHub上获得了超过15k的star，成为C++社区最受欢迎的日志解决方案之一。我最初选择spdlog是因为它在性能测试中表现突出 - 在i7-9700K处理器上单线程每秒能记录超过10万条日志，而多线程模式下这个数字可以达到数百万。

与其他日志库相比，spdlog有几个显著优势：

零内存分配：在日志记录的热路径上完全不进行动态内存分配，这大大减少了性能开销
极简API：只需要包含头文件即可使用，接口设计符合现代C++习惯
丰富的特性：支持多线程、日志轮转、多种日志级别等实用功能
跨平台：在Windows/Linux/macOS上表现一致，特别适合跨平台项目

提示：如果你正在使用Visual Studio开发Windows应用，spdlog与MSVC编译器的兼容性非常好，这也是我推荐它在Windows平台使用的重要原因。

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. Windows环境下的编译准备

2.1 系统与工具要求

在Windows上编译spdlog前，需要确保开发环境满足以下要求：

操作系统版本：Windows 10或更高版本（支持Windows 7但需要额外配置）
开发工具：
- Visual Studio 2019或2022（社区版即可）
- CMake 3.12或更高版本
- Git for Windows（用于克隆仓库）
可选组件：
- Windows SDK（通常随VS安装）
- C++桌面开发工作负载（VS安装时勾选）

2.2 获取spdlog源代码

推荐通过Git克隆最新版本的spdlog：

bash复制git clone https://github.com/gabime/spdlog.git
cd spdlog

如果你不想使用Git，也可以直接从GitHub下载zip包，但需要注意这种方式可能会缺少子模块（如fmt库）。

2.3 依赖管理

spdlog的主要依赖是fmt库，从v1.9.0开始，spdlog已经将fmt作为其实现的一部分。这意味着：

如果你使用spdlog的头文件方式，不需要单独处理fmt依赖
如果你需要静态链接spdlog，仍然需要确保fmt可用

在Windows上，我推荐使用vcpkg来管理这些依赖：

bash复制vcpkg install spdlog fmt

3. 使用Visual Studio编译spdlog

3.1 使用CMake生成解决方案

spdlog官方推荐使用CMake进行构建。以下是详细步骤：

bash复制mkdir build
cd build
cmake .. -G "Visual Studio 16 2019" -A x64

这里有几个关键点需要注意：

-G 指定生成器版本，应与你的VS版本匹配
-A x64 指定生成64位解决方案（也可以使用Win32生成32位版本）
如果需要静态库，添加 -DSPDLOG_BUILD_STATIC=ON

打开生成的解决方案文件：

bash复制start spdlog.sln

3.2 编译选项解析

在CMake配置阶段，有几个重要选项会影响编译结果：

选项	默认值	说明
SPDLOG_BUILD_EXAMPLE	ON	是否构建示例程序
SPDLOG_BUILD_TESTS	OFF	是否构建测试
SPDLOG_BUILD_BENCH	OFF	是否构建性能测试
SPDLOG_BUILD_SHARED	OFF	构建动态链接库
SPDLOG_WCHAR_SUPPORT	OFF	支持宽字符日志
SPDLOG_INSTALL	OFF	生成安装目标

我通常建议第一次使用时开启示例程序构建，这有助于理解库的使用方式。

3.3 常见编译问题解决

在Windows编译过程中可能会遇到以下问题：

找不到Windows SDK：
- 解决方案：通过Visual Studio Installer安装对应版本的Windows SDK
- 验证：运行 cmake --version 和 cl.exe 确保路径正确
链接错误 LNK2019：
- 通常是因为没有正确包含spdlog的头文件路径
- 确保在项目属性中添加包含目录 $(SPDLOG_ROOT)/include
C++标准不匹配：
- spdlog需要C++11或更高版本
- 在CMake中设置：set(CMAKE_CXX_STANDARD 11)

注意：如果你使用的是较旧的Visual Studio版本（如2015），可能需要额外指定 /Zc:__cplusplus 编译器选项来启用正确的C++标准检测。

4. 在项目中使用spdlog

4.1 基本使用方法

最简单的使用方式是作为头文件库（header-only）：

cpp复制#include "spdlog/spdlog.h"

int main() {
    // 创建控制台日志器
    auto console = spdlog::stdout_color_mt("console");
    
    // 设置日志级别
    spdlog::set_level(spdlog::level::debug);
    
    // 记录日志
    console->info("Welcome to spdlog!");
    console->error("Some error message with arg: {}", 1);
    
    // 全局模式
    spdlog::info("This is a global log message");
    
    spdlog::shutdown();
    return 0;
}

4.2 高级配置

spdlog提供了丰富的配置选项，以下是一些实用技巧：

日志格式定制：

cpp复制auto logger = spdlog::stdout_color_mt("custom_logger");
logger->set_pattern("[%Y-%m-%d %H:%M:%S.%e] [%l] [%n] %v");

文件日志记录：

cpp复制#include "spdlog/sinks/basic_file_sink.h"
auto file_logger = spdlog::basic_logger_mt("file_logger", "logs/basic-log.txt");

异步日志（推荐用于生产环境）：

cpp复制#include "spdlog/async.h"
spdlog::init_thread_pool(8192, 1); // 队列大小，线程数
auto async_file = spdlog::basic_logger_mt<spdlog::async_factory>(
    "async_file_logger", "logs/async-log.txt");

4.3 性能优化建议

在Windows平台上，我总结了以下性能优化经验：

使用异步日志：可以减少主线程阻塞，特别是在高负载情况下
避免频繁创建/销毁日志器：重用日志器对象

选择合适的刷新策略：

cpp复制logger->flush_on(spdlog::level::err); // 仅在错误级别刷新

预分配内存：对于已知大小的日志消息，可以使用 spdlog::memory_buf_t

5. Windows平台特有功能

5.1 调试输出

在Windows开发中，我们经常需要查看调试输出：

cpp复制#include "spdlog/sinks/msvc_sink.h"
auto debug_sink = std::make_shared<spdlog::sinks::msvc_sink_mt>();
spdlog::logger debug_logger("debug", debug_sink);
debug_logger.info("This will appear in Visual Studio's output window");

5.2 Windows事件日志

spdlog可以与Windows事件日志集成：

cpp复制#include "spdlog/sinks/win_eventlog_sink.h"
auto event_logger = spdlog::win_eventlog_logger_mt("windows_log", "MyApp");
event_logger->info("This message will appear in Windows Event Viewer");

5.3 性能计数器

Windows平台特有的高精度计时：

cpp复制#include "spdlog/stopwatch.h"
spdlog::stopwatch sw;
// ...执行一些操作...
spdlog::info("Elapsed: {} seconds", sw);

6. 实际项目集成案例

6.1 DLL项目中的使用

在Windows DLL中使用spdlog需要特别注意：

导出日志器：

cpp复制// 在DLL头文件中
#ifdef MYLIB_EXPORTS
#define MYLIB_API __declspec(dllexport)
#else
#define MYLIB_API __declspec(dllimport)
#endif

MYLIB_API std::shared_ptr<spdlog::logger>& get_logger();

实现文件：

cpp复制std::shared_ptr<spdlog::logger> g_logger;

MYLIB_API std::shared_ptr<spdlog::logger>& get_logger() {
    if (!g_logger) {
        g_logger = spdlog::stdout_color_mt("dll_logger");
    }
    return g_logger;
}

6.2 多模块项目配置

在大型项目中，我推荐采用以下结构：

code复制project/
├── CMakeLists.txt
├── src/
│   ├── module1/
│   └── module2/
└── third_party/
    └── spdlog/

在顶层CMakeLists.txt中添加：

cmake复制add_subdirectory(third_party/spdlog)
target_link_libraries(your_target PRIVATE spdlog::spdlog)

6.3 与Windows服务集成

在Windows服务中使用spdlog时：

使用每日文件日志：

cpp复制#include "spdlog/sinks/daily_file_sink.h"
auto daily_logger = spdlog::daily_logger_mt("daily_logger", "logs/daily.txt", 0, 0);

处理服务停止：

cpp复制BOOL WINAPI CtrlHandler(DWORD fdwCtrlType) {
    if (fdwCtrlType == SERVICE_CONTROL_STOP) {
        spdlog::shutdown();
        return TRUE;
    }
    return FALSE;
}

7. 调试与问题排查

7.1 常见运行时问题

日志文件无法写入：
- 检查文件路径权限
- 确保目录存在
- 在Windows服务中特别注意当前工作目录
日志丢失：
- 确保正确调用 spdlog::shutdown()
- 检查异步日志队列是否溢出
性能问题：
- 使用 spdlog::bench 示例测试基础性能
- 检查是否有过多的同步日志调用

7.2 调试技巧

启用spdlog的追踪日志：

cpp复制spdlog::set_level(spdlog::level::trace);

使用Visual Studio调试输出：

cpp复制OutputDebugStringA(spdlog::fmt_lib::format("Debug: {}\n", your_var).c_str());

内存泄漏检测：

在Visual Studio中启用内存泄漏检测：

cpp复制#define _CRTDBG_MAP_ALLOC
#include <crtdbg.h>

_CrtSetDbgFlag(_CRTDBG_ALLOC_MEM_DF | _CRTDBG_LEAK_CHECK_DF);

8. 进阶主题与扩展

8.1 自定义格式器

创建符合项目需求的日志格式：

cpp复制class custom_formatter : public spdlog::formatter {
public:
    void format(const spdlog::details::log_msg& msg, spdlog::memory_buf_t& dest) override {
        // 实现自定义格式逻辑
    }
};

auto logger = spdlog::stdout_color_mt("custom_format");
logger->set_formatter(std::make_unique<custom_formatter>());

8.2 网络日志

通过UDP发送日志到远程服务器：

cpp复制#include "spdlog/sinks/udp_sink.h"
auto udp_sink = std::make_shared<spdlog::sinks::udp_sink_mt>("192.168.1.100", 514);
spdlog::logger udp_logger("udp", udp_sink);

8.3 性能敏感场景优化

对于游戏等性能敏感应用：

使用栈分配缓冲区：

cpp复制spdlog::memory_buf_t<1024> buf;  // 栈分配缓冲区
spdlog::format_to(buf, "Message: {}", 42);

禁用异常：

在CMake中配置：

cmake复制target_compile_definitions(spdlog PUBLIC SPDLOG_NO_EXCEPTIONS)

编译时过滤日志级别：

cpp复制#define SPDLOG_ACTIVE_LEVEL SPDLOG_LEVEL_INFO
#include "spdlog/spdlog.h"

在实际项目中，我发现spdlog的灵活性足以满足绝大多数Windows平台C++应用的日志需求。特别是在长期运行的服务中，其稳定性和性能表现非常出色。一个实用的建议是：在项目早期就建立好日志规范，包括级别定义、格式标准和存储策略，这会在后期维护中节省大量时间。