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