c++如何实现简单的日志记录类_FILE与LINE宏应用【实战】

星瑶酱_3591

星瑶酱_3591

2026-03-26

779人浏览

原创

应使用 std::cout

c++如何实现简单的日志记录类_file与line宏应用【实战】

如何用 __FILE__ 和 __LINE__ 打印带位置信息的日志

直接在日志输出里拼接这两个宏,但别裸用——它们是字符串字面量和整数,std::cout 看似可行,实际会输出完整路径(比如 <code>"/home/user/proj/src/logger.cpp"),太长且不跨平台。更关键的是,__LINE__ 是整数,但日志常要格式化成一行字符串再写入文件或缓冲区,硬拼容易出类型错或临时对象生命周期问题。

实操建议:

  • 用 std::ostringstream 或 C++20 的 std::format 组装消息,避免隐式转换风险
  • 对 __FILE__ 做路径裁剪:只保留文件名,用 std::string_view(__FILE__).substr(...) 找最后一个 '/' 或 '\'
  • 宏定义时用 do { ... } while(0) 包裹,防止 if/else 分支下误展开
  • 示例:
    #define LOG_INFO(msg) do { 
        std::string_view file = __FILE__; 
        auto pos = file.find_last_of("/\"); 
        file = (pos != std::string_view::npos) ? file.substr(pos+1) : file; 
        std::ostringstream oss; 
        oss 

为什么不能把 __FILE__ 和 __LINE__ 直接塞进类成员函数参数

因为宏在预处理阶段展开,位置信息属于调用点,不是定义点。如果写一个 Logger::log(const char* file, int line, const char* msg),再在外部用 logger.log(__FILE__, __LINE__, "xxx"),看似合理,但实际破坏了封装性,每次调用都要手动传——没人会坚持这么做,迟早漏掉或写错。

实操建议:

  • 把宏封装成内联函数调用,比如 log_impl(__FILE__, __LINE__, msg),对外只暴露 LOG_INFO("xxx") 这种宏接口
  • 避免在类内部保存 __FILE__ 字符串——它可能指向不同编译单元,长度不可控,且静态存储期下多线程写入会冲突
  • 如果真要用成员函数接收位置信息,必须确保调用方始终用宏包裹,否则日志位置就失效了

__FILE__ 在头文件里展开会指向包含它的源文件,不是头文件本身

这是最常被忽略的一点。如果你把 LOG_INFO 宏定义在 logger.h 里,然后在 main.cpp 中 #include "logger.h" 并调用 LOG_INFO("test"),那么 __FILE__ 展开的是 "main.cpp",不是 "logger.h"。这其实是正确行为——日志该反映“谁在调用”,而不是“谁定义了宏”。

C++14
C++14

C++14 对 C++11 的修正与增强版本,适合旧系统维护和较老工具链兼容。

下载

但要注意:

  • 如果宏定义在头文件中,又用了 static inline 辅助函数,函数体内再用 __FILE__,那它还是指向头文件路径,不是调用点——因为函数体在头里,预处理时已固定
  • 想让日志位置精准到调用行,所有逻辑必须在宏里展开,不能下沉到独立函数体内
  • 跨模块共享日志宏时,确保头文件只含声明、不含实现,否则 ODR 违规

性能与线程安全的现实取舍

每次日志都做字符串拼接、路径裁剪、std::ostringstream 构造析构,开销不小。而加锁保护全局日志流又容易成为瓶颈。没有银弹,只有按场景选策略。

实操建议:

  • 调试期用全信息宏;发布版可条件编译去掉 __FILE__/__LINE__,或只保留文件名哈希值
  • 避免在循环内高频打日志,尤其带位置信息的——宏展开后每行都是独立字符串构造
  • 若需线程安全,优先用无锁环形缓冲区 + 单独日志线程消费,而不是给 std::ofstream 加互斥量
  • 不要用 std::cerr 直接输出——它默认行缓冲,但在重定向到文件时可能变全缓冲,导致日志延迟或丢失

宏展开的位置信息看着简单,但一旦涉及头文件包含、模板实例化、链接时优化,__FILE__ 和 __LINE__ 的行为边界就很容易滑出去。最稳的方式,是让宏完全自洽,不依赖外部函数体里的预定义宏。

C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!

相关文章

c++速学教程(入门到精通)
c++速学教程(入门到精通)

c++怎么学习?c++怎么入门?c++在哪学?c++怎么学才快?不用担心,这里为大家提供了c++速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

c++

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.03

1658

5

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

2504

5

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

2023.10.24

5964

49

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

2023.11.24

5349

6

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

2024.03.22

7054

16

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

2024.04.29

9994

11

go语言字符串相关教程
go语言字符串相关教程

本专题整合了go语言字符串相关教程,阅读专题下面的文章了解更多详细内容。

2025.07.29

5079

17

c++字符串相关教程
c++字符串相关教程

本专题整合了c++字符串相关教程,阅读专题下面的文章了解更多详细内容。

2025.08.07

5427

13

常用字符串方法大全
常用字符串方法大全

常用字符串方法大全

2025.08.08

2768

14

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习