不能直接在多线程中用 std::cout 打日志，因其内部缓冲区非线程安全，会导致乱序、字符交错或未定义行为；应采用 std::queue + std::mutex 实现异步日志队列，由单独线程消费输出。
为什么不能直接在多线程里用 std::cout 打日志
多个线程同时调用 std::cout << "msg" 会导致输出乱序、字符交错，甚至触发未定义行为——因为 std::cout 内部缓冲区不是线程安全的，且 C++ 标准不保证其并发写入的安全性。即使某些平台（如 Linux glibc）对 std::cout 做了加锁，也不该依赖它做日志，锁粒度大、性能差、无法控制格式和时机。
用 std::queue + std::mutex 做简单异步日志队列
核心思路是：所有线程只往一个线程安全队列里塞日志消息（字符串或结构体），由单独的日志线程负责从队列取、格式化、输出到 std::cout。这样避免了多线程争抢 std::cout，也解耦了日志产生与输出。
实操要点：
- 用
std::queue<std::string>存消息，配合std::mutex和std::condition_variable实现阻塞式消费 - 生产者（各业务线程）用
std::lock_guard<std::mutex>加锁后push()，然后notify_one() - 消费者（日志线程）在
wait()中检查队列是否非空，避免虚假唤醒 - 注意：不要在日志线程里做耗时操作（比如文件 I/O 或网络调用），否则会拖慢整个队列消费
示例关键片段：
立即学习“C++免费学习笔记（深入）”；
std::queue<std::string> log_queue;
std::mutex queue_mtx;
std::condition_variable queue_cv;
bool log_running = true;
<p>// 日志线程函数
auto logger_thread = std::thread([]{
while (log_running || !log_queue.empty()) {
std::string msg;
{
std::unique_lock<std::mutex> lk(queue_mtx);
queue_cv.wait(lk, []{ return !log_queue.empty() || !log_running; });
if (!log_queue.empty()) {
msg = std::move(log_queue.front());
log_queue.pop();
}
}
if (!msg.empty()) std::cout << msg << '\n' << std::flush;
}
});用 std::format（C++20）或 fmt::format 统一日志格式，避免拼接开销
如果每个线程都用 std::ostringstream 或多次 << 拼接日志字符串，会产生临时对象和内存分配；而日志线程再格式化又重复劳动。推荐统一在生产端完成格式化，把完整字符串入队。
实操建议：
- C++20 可直接用
std::format("[{}][{}] {}", std::chrono::system_clock::now(), thread_id, msg) - 若用 C++17 或更低，集成
fmt::format（轻量、零成本抽象、支持编译期检查）比手写snprintf更安全 - 避免在日志宏里无条件调用
std::chrono::steady_clock::now()——高频日志下它本身有开销，可考虑采样或延迟获取
如何防止日志队列无限增长导致 OOM
异步日志最大的风险不是乱序，而是消费者跟不上生产速度，log_queue 持续膨胀，最终吃光内存。没有背压机制的队列等于定时炸弹。
实用策略（按推荐顺序）：
- 设置最大队列长度（如 1000 条），入队前检查：
if (log_queue.size() >= MAX_SIZE) { /* drop or warn */ } - 用
std::deque替代std::queue，方便在满时pop_front()腾出空间（即“滚动日志”语义） - 极端场景下，可改用无锁环形缓冲区（如
boost::lockfree::spsc_queue），但需确保单生产者单消费者模型，且注意内存序和 ABA 问题 - 切勿在日志线程崩溃时静默吞掉异常——至少要
std::cerr << "logger died"并设标志位通知主逻辑
真正难的不是让日志“异步”，而是让它“可控”：什么时候丢、丢哪些、丢之前要不要告警——这些逻辑一旦漏掉，线上出问题时你看到的就不是日志，是一堆没时间戳、缺上下文、还被截断的碎片。
