C++中如何创建全局可用的Spdlog日志实例？报错求助

算力阿峰

2026-7-26

全局Spdlog每日轮转日志实例的实现问题

我在使用C++的Spdlog日志库时，发现官方示例都是在函数内部声明日志实例，比如：

void daily_example()
{   auto daily_logger = spdlog::daily_logger_mt("daily_logger", "logs/daily.txt", 2, 30);  }

这种写法能正常运行，但我正在编写设备驱动，需要创建一个全局的每日轮转日志文件/var/log/xxx.log，要求可以跨函数、跨源文件使用。

我尝试了多种方法都失败了：

直接声明全局变量：

auto daily_logger = spdlog::daily_logger_mt("daily_logger", "logs/daily.txt", 2, 30);

编译器报错无法调用daily_logger的debug方法，提示它是非类类型double(double)。

尝试继承spdlog：

class daily_log: public spdlog {
     public:
          void daily_log () {
               daily_logger_mt("daily_logger", "logs/daily.txt", 2, 30);
          }
};

编译器提示spdlog不是类。

自行封装log类：

class log {
    public:
        std::string filename = "/var/log/name-redacted.log";
        log () {
            auto daily_log = spdlog::daily_logger_st("daily_logger", filename, 0, 1 );
        }
};

调用log.debug("Logging Started.")时出现相同错误：

$ g++ simple-spdlog.cpp  -o logger -I/usr/include/spdlog -lspdlog
simple-spdlog.cpp: In function ‘int main(int, char**)’:
simple-spdlog.cpp:18:9: error: request for member ‘debug’ in ‘log’, which is of non-class type ‘double(double) throw ()’ {aka ‘double(double)’}
     log.debug("Logging Started.");

我怀疑是命名空间问题，但已经直接引用了spdlog命名空间，没法理解为什么行为不同。请问我哪里操作错了？怎么实现全局可用的Spdlog日志实例？

问题分析与解决方案

错误原因拆解

全局变量声明错误：
全局作用域中使用auto推导类型时，编译器无法在编译期确定spdlog::daily_logger_mt的返回类型（它返回的是std::shared_ptr<spdlog::logger>），导致类型推导失败，误将daily_logger解析成了函数声明（double(double)是因为编译器的默认类型推导错误）。
继承spdlog错误：
spdlog是命名空间，不是类，所以无法直接继承。日志实例的实际类型是spdlog::logger，但spdlog推荐使用智能指针来管理日志实例，而非直接继承。
自定义log类的错误：
- 你定义的log类内部只是在构造函数中创建了一个局部的日志实例，这个实例在构造函数结束后就会被销毁，外部无法访问。
- 调用log.debug(...)时，log是类名，不是对象实例，编译器把它当成了内置的log函数（数学对数函数），所以报出double(double)类型错误。

正确实现全局Spdlog实例的方法

方法1：使用全局智能指针+初始化函数

在头文件中声明全局变量，在源文件中初始化：

// log_global.h
#include <spdlog/spdlog.h>
#include <spdlog/sinks/daily_file_sink.h>

extern std::shared_ptr<spdlog::logger> g_daily_logger;

void init_global_logger();

// log_global.cpp
#include "log_global.h"

std::shared_ptr<spdlog::logger> g_daily_logger;

void init_global_logger() {
    // 初始化每日轮转日志，参数：logger名称、日志路径、小时、分钟（每天该时间轮转）
    g_daily_logger = spdlog::daily_logger_mt("global_daily_logger", "/var/log/xxx.log", 0, 1);
    // 设置日志级别（可选）
    g_daily_logger->set_level(spdlog::level::debug);
    // 设置格式（可选）
    g_daily_logger->set_pattern("[%Y-%m-%d %H:%M:%S] [%l] %v");
}

在主程序启动时先调用init_global_logger()，之后就能在任意源文件中包含log_global.h并使用g_daily_logger->debug(...)等方法。

方法2：使用单例模式封装

如果不想暴露全局变量，可以用单例类封装日志实例：

// log_singleton.h
#include <spdlog/spdlog.h>
#include <spdlog/sinks/daily_file_sink.h>
#include <memory>

class GlobalDailyLog {
public:
    static std::shared_ptr<spdlog::logger>& instance() {
        static std::shared_ptr<spdlog::logger> logger = spdlog::daily_logger_mt("singleton_daily_logger", "/var/log/xxx.log", 0, 1);
        // 首次初始化时设置配置
        static bool initialized = false;
        if (!initialized) {
            logger->set_level(spdlog::level::debug);
            logger->set_pattern("[%Y-%m-%d %H:%M:%S] [%l] %v");
            initialized = true;
        }
        return logger;
    }

    // 禁止拷贝和移动
    GlobalDailyLog(const GlobalDailyLog&) = delete;
    GlobalDailyLog& operator=(const GlobalDailyLog&) = delete;
    GlobalDailyLog(GlobalDailyLog&&) = delete;
    GlobalDailyLog& operator=(GlobalDailyLog&&) = delete;

private:
    GlobalDailyLog() = default;
};

// 简化调用的宏（可选）
#define LOG_DEBUG(msg) GlobalDailyLog::instance()->debug(msg)
#define LOG_INFO(msg) GlobalDailyLog::instance()->info(msg)

使用时直接调用：

#include "log_singleton.h"

void some_function() {
    GlobalDailyLog::instance()->debug("跨函数日志");
    LOG_INFO("通过宏简化调用");
}

注意事项

设备驱动场景下，要确保/var/log目录存在且程序有写入权限，否则日志初始化会失败。
多线程环境下使用daily_logger_mt（多线程安全），单线程场景用daily_logger_st即可。
全局实例初始化要在程序启动的早期完成，避免未初始化就调用日志方法。

内容的提问来源于stack exchange，提问作者K. Trotman

C++中如何创建全局可用的Spdlog日志实例？报错求助

问题分析与解决方案 #

错误原因拆解 #

正确实现全局Spdlog实例的方法 #