推荐用枚举类定义日志级别（如enum class loglevel {debug=0, info=1, warn=2, error=3, fatal=4}），支持隐式转int、作用域安全、易扩展；前缀应统一在log入口生成，含时间戳和级别标签，避免手动拼接。
日志级别怎么定义才方便后续扩展
直接用整数常量（比如 DEBUG=1, ERROR=4）容易出错，也难维护。推荐用枚举类，既能限制取值范围，又支持隐式转换为整数用于比较：
enum class LogLevel {
DEBUG = 0,
INFO = 1,
WARN = 2,
ERROR = 3,
FATAL = 4
};
注意不要用普通 enum，否则会污染作用域；也不要给每个级别单独写宏——后期加个 TRACE 就得改一堆宏定义。
-
LogLevel必须可隐式转int（C++11 起枚举类默认不支持，需加operator int()或用static_cast显式转换） - 级别数值必须严格递增，方便做
log_level >= current_threshold这类判断 - 避免用字符串名（如
"ERROR"）作为级别标识——运行时比较慢，且无法在编译期校验
如何让日志输出自动带时间戳和级别标签
别在每次调用 log() 时手动拼接时间——性能差、易出错、格式不统一。应该在日志函数入口处统一生成前缀：
std::string make_prefix(LogLevel level) {
auto now = std::chrono::system_clock::now();
auto time_t = std::chrono::system_clock::to_time_t(now);
auto ms = std::chrono::duration_cast<:chrono::milliseconds>(
now.time_since_epoch()).count() % 1000;
std::stringstream ss;
ss
<p><code>level_to_string()</code> 是个简单 switch，返回 <code>"DEBUG"</code>/<code>"ERROR"</code> 等字符串。关键点是：时间戳必须在进入日志函数后立刻获取，否则多线程下可能和实际写入时间偏差几十毫秒。</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill4025" title="C++ 算法竞赛自动化测试数据生成与校验框架"><img
src="https://img.php.cn/upload/skill/000/000/081/178988956499722.jpg" alt="C++ 算法竞赛自动化测试数据生成与校验框架" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill4025" title="C++ 算法竞赛自动化测试数据生成与校验框架" class="overflowclass">C++ 算法竞赛自动化测试数据生成与校验框架</a>
<p class="overflowclass">根据原题生成新题面、验证器及完整测试数据，自动套用 testlib 模板，用于用户要求生成测试数据时。</p>
</div>
<a rel="nofollow" href="/xiazai/skill4025" title="C++ 算法竞赛自动化测试数据生成与校验框架" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
<ul>
<li>别用 <code>std::time(nullptr)</code> ——精度只有秒级，且不线程安全（某些旧 libc 实现）</li>
<li>别在构造 <code>std::stringstream</code> 前调用 <code>std::localtime</code> ——它返回静态缓冲区指针，多线程下会被覆盖</li>
<li>毫秒部分用 <code>count() % 1000</code>，不是 <code>time_since_epoch().milliseconds().count()</code> ——后者精度丢失</li>
</ul>
<h3>为什么不能直接用 <code>std::cout</code> 输出日志</h3>
<p><code>std::cout</code> 默认行缓冲，但日志必须“立即可见”，尤其在崩溃前最后几条日志——如果卡在缓冲区里就全丢了。更严重的是：<code>std::cout</code> 不是线程安全的，多个线程同时
</p>
<ul>
<li>必须用 <code>std::cerr</code> 或自建文件流，并显式调用 <code>flush()</code>
</li>
<li>若输出到文件，要打开 <code>std::ios::unitbuf</code> 模式（每条日志自动 flush），或每次写完手动 <code>stream.flush()</code>
</li>
<li>生产环境禁用 <code>std::cout</code> 输出日志——它可能被重定向、被其他库干扰、甚至被关闭</li>
<li>调试阶段可临时把日志输出到 <code>std::cerr</code>，但上线前必须切换到独立文件流</li>
</ul>
<h3>如何实现线程安全的日志写入而不拖慢主线程</h3>
<p>同步锁整个日志函数（比如在 <code>log()</code> 开头加 <code>std::lock_guard</code>）会让所有线程排队等一个 mutex，吞吐量骤降。正确做法是：日志内容先入队，由单独日志线程异步刷盘。</p>
<pre class="brush:php;toolbar:false;">std::queue<:string> log_queue;
std::mutex queue_mutex;
std::condition_variable cv;
bool stop_logging = false;
void logging_thread() {
std::ofstream file("app.log", std::ios::app);
while (!stop_logging || !log_queue.empty()) {
std::string msg;
{
std::unique_lock<:mutex> lock(queue_mutex);
cv.wait(lock, []{ return !log_queue.empty() || stop_logging; });
if (!log_queue.empty()) {
msg = std::move(log_queue.front());
log_queue.pop();
}
}
if (!msg.empty()) file
<p>注意 <code>cv.wait()</code> 的 predicate 必须同时检查队列非空和退出标志，否则可能死锁。另外，<code>std::ofstream</code> 在多线程下不能共享——必须在日志线程内独占打开。</p>
<ul>
<li>别用 <code>std::shared_ptr</code> 包裹日志消息传入队列——堆分配开销大，不如直接 move <code>std::string</code>
</li>
<li>日志线程必须设置 <code>std::this_thread::sleep_for(1ms)</code> 在空队列时让出 CPU，否则 busy-wait 白耗资源</li>
<li>程序退出前必须置 <code>stop_logging = true</code> 并 <code>cv.notify_one()</code>，否则日志线程永远卡在 wait</li>
</ul>
<p>最麻烦的其实是日志滚动和磁盘满处理——这些不在“简单”范畴里，但一旦忽略，跑几天就停服。</p></:mutex></:string>C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
