如何从Python端配置pybind11模块中使用的spdlog日志器

由于Python的spdlog库与你C代码中的spdlog是完全独立的实例，无法直接共享配置，最直接的解决方式是在C端编写日志配置接口，再通过pybind11绑定到Python，让Python直接控制C++侧的日志器。

步骤1：在C++中实现日志配置工具函数 #

编写全局工具函数，用于创建或配置指定名称的日志器，兼容你原有类的日志器获取逻辑：

#include "spdlog/spdlog.h"
#include "spdlog/sinks/stdout_color_sinks.h"

// 设置指定日志器的级别
void set_logger_level(const std::string& logger_name, spdlog::level::level_enum level) {
    auto logger = spdlog::get(logger_name);
    if (!logger) {
        // 日志器未创建时，先初始化默认彩色控制台日志器
        logger = spdlog::stdout_color_mt(logger_name);
    }
    logger->set_level(level);
}

// 设置指定日志器的输出格式
void set_logger_pattern(const std::string& logger_name, const std::string& pattern) {
    auto logger = spdlog::get(logger_name);
    if (!logger) {
        logger = spdlog::stdout_color_mt(logger_name);
    }
    logger->set_pattern(pattern);
}

// 可选：获取当前日志器的级别
spdlog::level::level_enum get_logger_level(const std::string& logger_name) {
    auto logger = spdlog::get(logger_name);
    return logger ? logger->level() : spdlog::level::info;
}

步骤2：用pybind11绑定配置接口到Python #

在pybind11的绑定代码中，暴露上述函数和spdlog的日志级别枚举，方便Python调用：

#include <pybind11/pybind11.h>
#include <pybind11/enum.h>

namespace py = pybind11;

PYBIND11_MODULE(your_module_name, m) {
    // 绑定日志级别枚举，让Python能直接使用对应级别
    py::enum_<spdlog::level::level_enum>(m, "LogLevel")
        .value("trace", spdlog::level::trace)
        .value("debug", spdlog::level::debug)
        .value("info", spdlog::level::info)
        .value("warn", spdlog::level::warn)
        .value("err", spdlog::level::err)
        .value("critical", spdlog::level::critical)
        .value("off", spdlog::level::off);

    // 绑定日志配置函数
    m.def("set_logger_level", &set_logger_level, "设置指定名称日志器的级别",
          py::arg("logger_name"), py::arg("level"));
    m.def("set_logger_pattern", &set_logger_pattern, "设置指定名称日志器的输出格式",
          py::arg("logger_name"), py::arg("pattern"));
    m.def("get_logger_level", &get_logger_level, "获取指定名称日志器的当前级别",
          py::arg("logger_name"));

    // 继续绑定你的业务类（如MyClass）
    py::class_<MyClass>(m, "MyClass")
        .def(py::init<>());
}

步骤3：Python端调用配置接口 #

现在可以在Python中直接配置C++侧的日志器，完全不需要修改原有类的构造逻辑：

import your_module_name as m

# 先配置目标日志器，再创建类实例
m.set_logger_level(m.MyClass.LOGGER_NAME, m.LogLevel.debug)
m.set_logger_pattern(m.MyClass.LOGGER_NAME, "[%l] %n: %v")

# 创建的MyClass会自动复用已配置好的日志器
c = m.MyClass()

进阶优化：全局日志配置 #

如果需要统一配置所有日志器，可以添加全局配置函数：

// 设置全局默认日志级别
void set_global_log_level(spdlog::level::level_enum level) {
    spdlog::set_level(level);
}

// 设置全局默认日志格式
void set_global_log_pattern(const std::string& pattern) {
    spdlog::set_pattern(pattern);
}

绑定到Python后，即可一键配置所有日志器：

m.set_global_log_level(m.LogLevel.debug)
m.set_global_log_pattern("[%l] %n: %v")

方案优势 #

完全兼容你原有代码中spdlog::get的逻辑，无需修改任何业务类的构造函数，通过Python调用C++端的配置接口，确保日志器实例完全共享，配置直接生效。

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