推荐程序启动时以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 导致的性能陷阱
很多人习惯用 换行，但它等价于 。高频日志场景下，每次写都刷盘会严重拖慢性能。实际只需在关键节点（如进程退出前、每 100 条日志）手动 flush 即可。
- 用
'\n'替代std::endl可提升 2–5 倍写入吞吐量（取决于磁盘和缓冲区大小） - 若需保证崩溃前日志不丢失，可在主循环中定期
flush，或用setvbuf改为行缓冲（对ofstream需用rdbuf()->pubsetbuf，但跨平台兼容性差） - 调试阶段可开启自动 flush（如宏控制），发布时关闭
Windows 下中文日志乱码问题怎么解
在 Windows 控制台或记事本中打开日志文件显示乱码，大概率是编码问题。VS 默认用 GBK 编译源码，但 ofstream 写出的是 UTF-8 字节流（无 BOM），记事本会误判为 ANSI。
立即学习“C++免费学习笔记（深入）”；
- 最稳妥方式：写入前将字符串转为 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)，它依赖系统区域设置，部署到其他机器可能崩。
