Qt下实现全局可用免频繁开关文件的C++日志类方案咨询

你现有的代码存在几处可优化/修复点：

• 构造函数声明后多了多余分号，file.open判断缺少右括号
• 没有析构函数释放QFile和QTextStream资源，程序退出时未写入磁盘的缓存内容会丢失
• 直接使用全局对象存在初始化顺序不确定的风险，其他全局对象构造时调用日志会触发未定义行为

推荐方案：单例模式实现（满足Log() << xxx调用要求） #

该方案全局仅初始化一次日志实例，文件只会打开一次，不需要每次写日志开关文件，同时避免全局对象的初始化顺序问题：

完整实现代码 #

#include <QFile>
#include <QTextStream>
#include <QMutex>

class Logger
{
private:
    QFile* m_file;
    QTextStream* m_stream;
    QMutex m_mutex; // 多线程场景下保证线程安全，单线程使用可删除

    // 私有构造函数，禁止外部创建实例
    explicit Logger(const QString& filePath)
        : m_file(new QFile(filePath))
        , m_stream(nullptr)
    {
        // 用追加模式打开，避免覆盖旧日志，不需要读写模式
        if (m_file->open(QIODevice::WriteOnly | QIODevice::Append | QIODevice::Text)) {
            m_stream = new QTextStream(m_file);
            // 可选设置UTF-8编码
            m_stream->setEncoding(QStringConverter::Utf8);
        }
    }

    // 禁止拷贝、移动
    Logger(const Logger&) = delete;
    Logger& operator=(const Logger&) = delete;
    Logger(Logger&&) = delete;
    Logger& operator=(Logger&&) = delete;

public:
    // 析构函数自动释放资源、刷写缓存
    ~Logger()
    {
        if (m_stream) {
            m_stream->flush();
            delete m_stream;
        }
        if (m_file) {
            m_file->close();
            delete m_file;
        }
    }

    // 获取全局唯一实例，C++11及以上标准保证静态局部变量初始化线程安全
    static Logger& instance()
    {
        static Logger ins("Logs.txt");
        return ins;
    }

    // 重载<<运算符，支持流式输出，和std::cout用法完全一致
    template<typename T>
    Logger& operator<<(const T& data)
    {
        QMutexLocker locker(&m_mutex); // 单线程使用可删除此行
        if (m_stream) {
            *m_stream << data;
            // 可选：每次输出自动刷写缓存，避免程序崩溃时丢失日志，不需要可删除
            m_stream->flush();
        }
        return *this;
    }
};

// 全局包装函数，实现你需要的Log()调用形式
inline Logger& Log()
{
    return Logger::instance();
}

使用示例 #

你不需要在main函数里手动创建Logger实例，程序任意位置都可以直接调用：

int main(int argc, char *argv[])
{
    MyProgram a(argc, argv);
    // 直接使用，支持任意QTextStream可接受的类型
    Log() << "程序启动成功\n";
    Log() << "数字：" << 1024 << " 字符串：" << "测试日志" << Qt::endl;
    return a.exec();
}

简易替代方案：全局对象+包装函数（不推荐） #

如果你坚持使用全局对象的形式，可以按以下方式实现，但是要注意避免其他全局对象构造阶段调用Log()，否则会因为Logger未初始化触发崩溃：

1. 在全局头文件中声明外部实例和包装函数：

extern Logger g_logger;
inline QTextStream* Log() { return g_logger.Log(); }

2. 在main函数所在cpp文件中定义全局实例：

Logger g_logger("Logs.txt");

int main(int argc, char *argv[])
{
    MyProgram a(argc, argv);
    Log() << "测试日志";
    return a.exec();
}

可选优化点 #

• 可以在重载的<<运算符中自动追加时间戳、线程ID、日志级别等信息，方便日志排查
• 可以增加日志分片逻辑，当日志文件达到指定大小时自动创建新文件，避免单文件过大
• 可以增加控制台输出通道，方便开发阶段调试

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