在C++20中，std::source_location 提供了一种无需宏或手动输入即可自动获取代码位置信息的方法。它常用于日志记录、调试输出和错误报告，能自动捕获文件名、行号、函数名等上下文信息，极大提升了开发效率。

std::source_location 是什么？

std::source_location 是 头文件中的一个类，属于 C++20 新增的实用工具。它封装了当前代码的源码位置信息，包括：

• 文件路径（file_name）
• 行号（line）
• 列号（column）— 通常支持有限
• 函数名（function_name）

这些信息在编译时自动生成，不需要程序员手动填写。

如何使用 std::source_location

最常见的用法是将 std::source_location::current() 作为函数参数，默认传递，这样调用时无需显式传参。

示例：打印调试信息

#include <iostream>
#include <source_location>
#include <string>

void log_debug(const std::string& message,
               const std::source_location& loc = std::source_location::current())
{
    std::cout << "文件: " << loc.file_name() << "\n"
               << "行号: " << loc.line() << "\n"
               << "函数: " << loc.function_name() << "\n"
               << "消息: " << message << "\n\n";
}

void some_function() {
    log_debug("进入函数处理");
}

调用 some_function() 时，输出类似：

文件: main.cpp
行号: 12
函数: some_function
消息: 进入函数处理

实际应用场景

利用 std::source_location 可以增强日志系统和断言机制的实用性。

剪映出品的AI视频和图片创作助手

• 日志系统集成：自动标注每条日志来自哪个文件和函数，方便追踪问题。
• 自定义断言：当条件失败时，打印出错位置。
• 性能监控：记录函数执行起点和耗时，并标记来源。

例如，实现一个简单的断言宏替代：

void debug_assert(bool condition, const std::string& msg = "",
                  const std::source_location& loc = std::source_location::current())
{
    if (!condition) {
        std::cerr << "断言失败！\n"
                  << "文件: " << loc.file_name() << "\n"
                  << "行号: " << loc.line() << "\n"
                  << "函数: " << loc.function_name() << "\n"
                  << "说明: " << msg << "\n";
        std::terminate();
    }
}

使用方式简洁：

debug_assert(ptr != nullptr, "指针不能为空");

失败时会自动显示调用位置。

注意事项与限制

std::source_location 虽然方便，但有几点需要注意：

• 仅 C++20 及以上版本支持
• 函数名可能包含编译器修饰符号（如 GCC 的 _Z 开头），可借助 c++filt 工具解析
• 不能跨线程传递保证有效性（但数据是拷贝的，通常安全）
• column() 信息在多数编译器中不准确或固定为 0

基本上就这些。合理使用 std::source_location，可以让调试信息更智能，减少手动维护位置信息的负担，提升代码可维护性。