讲师中心 微信公众号
AI工具推荐 视频效率加速

C++ std::source_location用法 _ 替代宏定义的日志定位工具【详解】

老伟大大_4085

老伟大大_4085

发布时间:2026-04-12 20:13:33

|

587人浏览过

|

来源于php中文网

原创

std::source_location不能直接传参调用,必须作为带默认值的函数参数(= std::source_location::current())才能在调用点注入正确位置;否则因consteval特性导致所有日志显示同一位置。

c++ std::source_location用法 _ 替代宏定义的日志定位工具【详解】

std::source_location 能完全替代 __FILE__ 和 __LINE__ 宏,但必须用对方式——它不是宏,不能“传进去”,只能靠编译器在调用点自动注入。

为什么直接把 std::source_location::current() 当实参传会失效

常见错误是写成这样:

log("error");                     // ✅ 正确:靠默认参数触发注入
log("error", std::source_location::current()); // ❌ 错误:所有日志都显示同一个位置

因为 std::source_location::current() 是 consteval 函数,它的返回值在编译期就确定了;一旦你在函数体里、类成员初始化列表里或全局作用域中调用它,得到的就是那个“定义点”的位置,而不是“调用点”的位置。

  • 所有日志都显示构造函数所在行或头文件包含行
  • 多处调用却只记录一个固定文件名和行号
  • 调试时完全无法定位真实出错位置

std::source_location 必须作为带默认值的函数参数

正确姿势只有一种:声明函数时,把 std::source_location 设为带默认值的参数,且默认值只能是 std::source_location::current():

立即学习“C++免费学习笔记(深入)”;

C++14
C++14

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

下载
void log(const char* msg, const std::source_location& loc = std::source_location::current()) {
    printf("[%s:%d] %s
", loc.file_name(), loc.line(), msg);
}

这时每次调用 log("xxx"),编译器会在该调用语句处生成对应的位置信息,填入 loc。

  • 不能用 auto 推导这个参数类型(C++ 不允许推导默认参数)
  • 不能省略 const & —— 值拷贝无意义,引用更轻量
  • 不能把它塞进模板参数包或变参函数末尾(如 template<typename... args> void log(Args&&... args)</typename...>),否则无法保证注入时机

如何让日志里的文件名更简洁(不显示完整路径)

loc.file_name() 返回的是完整路径字符串(如 /home/user/proj/src/main.cpp),直接打出来不利于阅读。但别在日志函数里做 std::string 构造或 strrchr 截取——高频日志路径要避免隐式分配和重复计算。

稳妥做法是封装一个 short_file_name() 辅助函数,在调用点就完成裁剪:

const char* short_file_name(const char* full) {
#if defined(_WIN32)
    const char* last = strrchr(full, '\');
#else
    const char* last = strrchr(full, '/');
#endif
    return last ? last + 1 : full;
}
<p>void log(const char* msg, const std::source_location& loc = std::source_location::current()) {
printf("[%s:%d] %s
", short_file_name(loc.file_name()), loc.line(), msg);
}
  • Windows 下需同时处理 '\' 和 '/',但多数现代编译器(MSVC/Clang/GCC)在 Windows 上也输出 '/' 分隔符,所以单用 strrchr(full, '/') 通常够用
  • 不要用 std::filesystem::path——它会触发堆分配,且 C++17 起才有,和 C++20 的 source_location 并非强绑定
  • 如果项目已用构建系统(如 CMake)定义了源码根目录,也可考虑编译期裁剪(通过宏 + 字符串字面量处理),但复杂度陡增,一般没必要

兼容性与性能上最容易被忽略的三点

它确实“零运行时开销”,但有三个实际影响点常被低估:

  • GCC 10+、Clang 11+、MSVC 19.29+ 才支持;旧版本编译直接失败,别指望 -std=c++20 就能开箱即用
  • 每个启用 source_location 默认参数的函数,调用点会嵌入几个字节的常量数据(文件名地址、行号等),若函数未内联(比如跨 TU 或含复杂模板),这些数据会在多个目标文件里重复出现
  • 调试符号体积会明显增大——编译器需保留更多源码映射关系,不影响运行速度,但 strip 后的发布包 size 增长可忽略,debug 包的 DWARF 信息会变大

真正要注意的,是别在每毫秒打 1000 条日志的热路径里无条件启用它;用编译开关(如 #ifdef DEBUG_LOG)包裹日志函数声明,才是工程实践中最务实的做法。

热门AI工具

更多
小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

6639

2023.08.02

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

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

6144

2023.10.24

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

2278

2023.09.20

js 字符串转数组
js 字符串转数组

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

1798

2023.08.03

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

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

2804

2023.09.04

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

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

6144

2023.10.24

字符串介绍
字符串介绍

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

5889

2023.11.24

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

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

7514

2024.03.22

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

60

2026.10.22

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Gradle 安全最佳实践
Gradle 安全最佳实践

共0课时 | 0人学习

Gradle Wrapper 使用与安全指南
Gradle Wrapper 使用与安全指南

共0课时 | 0人学习

Golangci-lint命令行使用演示
Golangci-lint命令行使用演示

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn