std::source_location不能自动追踪异常抛出点,必须显式传入并封装到自定义异常类中;其成员为编译期字面量,不参与异常传播或运行时栈遍历。

std::source_location 不能自动追踪异常抛出点——它必须显式传入,不参与异常传播机制。
std::source_location 不会随异常自动捕获位置信息
很多人误以为 throw 时 std::source_location::current() 会像 Java 的 stack trace 那样被隐式记录。实际并非如此:C++ 异常对象本身不携带源码位置,std::source_location 是一个轻量值类型,只在调用 current() 的那一行编译期生成文件名、行号、函数名等字面量,不涉及运行时栈遍历。
这意味着:如果你在 catch 块里调用 std::source_location::current(),得到的是 catch 点的位置,不是 throw 点。
- throw 发生在
foo.cpp:42,但catch在bar.cpp:89→current()返回后者 - 异常类型若未显式保存
std::source_location成员,就完全丢失抛出位置 - 标准库的
std::exception及其派生类(如std::runtime_error)均不含该字段
手动封装异常以携带 source_location(推荐做法)
最直接可靠的方案是自定义异常基类,在构造时捕获当前位置,并提供访问接口。这样既保持语义清晰,又避免宏污染。
class tracked_exception : public std::runtime_error {
public:
tracked_exception(const std::string& msg,
const std::source_location loc = std::source_location::current())
: std::runtime_error(msg),
m_loc(loc) {}
const std::source_location& location() const noexcept { return m_loc; }
private:
std::source_location m_loc;
};
使用时:
- 替换原始
throw std::runtime_error("bad value")为throw tracked_exception("bad value") - 在
catch (const tracked_exception& e)中可安全调用e.location().file_name()、e.location().line()等 - 注意:不要在构造函数中对
loc做任何可能抛异常的操作(如字符串拼接),否则可能二次崩溃
用宏简化调用,但需警惕调试与内联行为
为减少重复书写 std::source_location::current(),可用宏封装。但要注意宏展开后影响调试符号和函数内联判断。
#define THROW_TRACKED(msg) \
throw tracked_exception(msg, std::source_location::current())
典型用法:THROW_TRACKED("timeout exceeded")。
- 宏展开后,
current()确实反映宏调用处的源码位置(而非宏定义内部) - 但某些调试器(如 older GDB)可能无法在宏调用行准确停住;建议开发期配合
-g3 -O0使用 - 若函数被强制 inline(如加了
[[gnu::always_inline]]),而宏又含复杂逻辑,可能引发编译错误或意外行为 - 不建议在头文件中无条件定义该宏——容易与其他项目冲突;可用
namespace detail+ 内联函数替代
std::source_location 的编译期特性带来的限制
它的所有成员(file_name()、function_name()、line())返回的都是字面量指针(const char*),生命周期绑定到可执行文件映像,不可修改、不可 move,也不参与 RTTI 或动态分配。
- 不能把它存进
std::shared_ptr或通过网络发送——它不是“数据”,而是编译器注入的地址常量 - 启用 LTO(Link Time Optimization)时,
function_name()可能被优化为"<unknown>"</unknown>,尤其当函数被内联或重命名 - 跨 shared library 边界传递时,
file_name()指向的是编译该 so/dll 时的绝对路径(除非用-frecord-gcc-switches或 CMake 的set(CMAKE_CXX_FLAGS "${CXX_FLAGS} -frecord-gcc-switches")控制)
真正需要自动化追踪异常位置的场景,往往得结合外部工具(如 AddressSanitizer 的 ASAN_OPTIONS=abort_on_error=1:handle_abort=1)或日志框架(如 spdlog 的 SPDLOG_COMPILED_LIB + 自定义 sink)。std::source_location 是个好帮手,但不是银弹——它只解决“我在哪抛的”,不解决“谁调了我的函数”。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











