C++实现简单日志系统及文件输出方法

推荐程序启动时以std::ios::app模式打开std::ofstream并保持开启，需显式.flush()或用std::endl刷新缓冲区；路径用/或\\；务必检查is_open()防静默失败。

用 std::ofstream 实现基础日志写入

最直接的方式是每次记录日志时打开文件、追加内容、再关闭。但频繁开闭文件效率低，且多线程下容易出错。推荐在程序启动时打开一个 std::ofstream 对象并保持打开状态，用 std::ios::app 模式确保追加写入。

• 必须显式调用 .flush() 或使用 std::endl（它会触发刷新），否则日志可能滞留在缓冲区不落盘
• 路径需用正斜杠 / 或双反斜杠 \\，单反斜杠 \ 在字符串中是转义符，会导致编译错误或路径异常
• 建议检查 ofstream.is_open()，避免静默失败（比如目录不存在、权限不足）

std::ofstream log_file("app.log", std::ios::app);
if (!log_file.is_open()) {
    std::cerr << "Failed to open log file\n";
    return;
}
log_file << "[INFO] Application started at " << std::time(nullptr) << "\n";
log_file.flush(); // 关键：确保立即写入磁盘

封装成线程安全的简易日志类

裸用 std::ofstream 在多线程场景下会因竞态导致日志错乱（如两行内容混在同一行）。加 std::mutex 是最低成本方案，但注意不要在锁内做耗时操作（比如格式化时间）。

• 时间戳应在加锁前生成，避免锁住 std::time 或 std::chrono 调用（虽然快，但没必要）
• 避免在日志函数里抛异常（比如 ofstream 写入失败），否则可能破坏调用栈；改用返回错误码或静默丢弃
• 构造函数中传入文件路径比硬编码更灵活，也方便单元测试重定向到内存流

class SimpleLogger {
    std::ofstream file_;
    mutable std::mutex mtx_;
public:
    explicit SimpleLogger(const std::string& path) : file_(path, std::ios::app) {}
    void log(const std::string& level, const std::string& msg) const {
        auto now = std::chrono::system_clock::now();
        auto time_t = std::chrono::system_clock::to_time_t(now);
        std::ostringstream oss;
        oss << "[" << level << "] " << std::put_time(std::localtime(&time_t), "%Y-%m-%d %H:%M:%S") << " - " << msg << "\n";
        std::lock_guard lock(mtx_);
        file_ << oss.str();
        file_.flush();
    }
};

避免 std::endl 导致的性能陷阱

很多人习惯用 << std::endl 换行，但它等价于 << '\n' << std::flush。高频日志场景下，每次写都刷盘会严重拖慢性能。实际只需在关键节点（如进程退出前、每 100 条日志）手动 flush 即可。

• 用 '\n' 替代 std::endl 可提升 2–5 倍写入吞吐量（取决于磁盘和缓冲区大小）
• 若需保证崩溃前日志不丢失，可在主循环中定期 flush，或用 setvbuf 改为行缓冲（对 ofstream 需用 rdbuf()->pubsetbuf，但跨平台兼容性差）
• 调试阶段可开启自动 flush（如宏控制），发布时关闭

Windows 下中文日志乱码问题怎么解

在 Windows 控制台或记事本中打开日志文件显示乱码，大概率是编码问题。VS 默认用 GBK 编译源码，但 ofstream 写出的是 UTF-8 字节流（无 BOM），记事本会误判为 ANSI。

• 最稳妥方式：写入前将字符串转为 UTF-8（如果源字符串是宽字符 std::wstring），或直接用 UTF-8 字面量（C++11 起支持 u8"中文"）
• 若必须用本地编码（如 GBK），可用 std::codecvt_utf8_utf16 转换，但该类在 C++17 已被弃用，不推荐新项目使用
• 简单验证：用 VS Code 或 Notepad++ 打开日志文件，手动切换编码看是否恢复正常；若正常，说明只是查看工具没识别 UTF-8

真正难处理的是日志内容来自用户输入或第三方 API 的宽字符串——这时候绕不开编码转换，别图省事用 WideCharToMultiByte(CP_ACP)，它依赖系统区域设置，部署到其他机器可能崩。