c++oding="utf-8" ?>
std::source_location可精准捕获崩溃时的文件名、函数名、行号与列号。通过自定义异常类注入位置信息、结合set_terminate记录未捕获异常上下文、宏封装实现零侵入插桩、联动backtrace增强堆栈完整性、启用编译器标准兼容模式保障可靠性，五种方法协同提升C++崩溃定位效率。
当C++程序发生崩溃时，若缺乏精确的源码位置信息，定位问题将变得异常困难。std::source_location 提供了在编译期自动捕获文件名、函数名、行号与列号的能力，可嵌入日志或异常处理路径中，辅助快速识别崩溃触发点。以下是利用该特性实现崩溃堆栈定位的关键方法：
一、在异常抛出点注入 source_location
通过自定义异常类或包装函数，在抛出异常的瞬间捕获当前源码位置，使异常对象携带可追溯的上下文信息。
1、定义携带 source_location 的异常类，包含成员 std::source_location loc；
2、在构造函数中使用 std::source_location::current() 初始化 loc 成员；
3、在可能引发崩溃的逻辑分支前，使用 throw MyException{} 形式主动抛出；
4、在 catch 块中通过 loc.file_name()、loc.function_name()、loc.line() 输出定位信息。
二、结合 set_terminate 实现未捕获异常的自动记录
当异常未被任何 catch 捕获而触发 terminate 时，可通过自定义 terminate_handler 获取最后一次已知的 source_location 上下文，前提是该上下文已在异常传播链中预先存储。
1、声明全局 std::atomic<:source_location> g_last_location；
2、在关键函数入口处插入 g_last_location.store(std::source_location::current(), std::memory_order_relaxed)；
3、注册自定义 terminate 处理器，调用 g_last_location.load().file_name() 等成员输出；
4、确保所有可能跳转至 terminate 的路径（如 noexcept 函数内抛异常）均完成 location 存储。
三、宏封装实现零侵入式插桩
借助预处理器宏，在不修改业务代码结构的前提下，为指定函数或作用域自动注入 source_location 记录逻辑，降低人工遗漏风险。
1、定义宏 LOG_LOCATION_AT_ENTRY，展开为 std::source_location _loc = std::source_location::current()；
2、定义宏 CRASH_GUARD，包裹函数体并在开头执行 LOG_LOCATION_AT_ENTRY，结尾写入线程局部存储；
3、在崩溃信号处理函数（如 SIGSEGV 的 sigaction 回调）中读取该线程局部变量；
4、对关键函数添加 CRASH_GUARD 包裹，例如 CRASH_GUARD { /* 原函数体 */ }。
四、与 backtrace 配合增强堆栈完整性
std::source_location 仅提供单点位置，需结合运行时堆栈回溯获取调用链。GNU libc 的 backtrace 与 backtrace_symbols_fd 可补全从崩溃点到入口的完整路径。
1、在 signal handler 中调用 backtrace 获取 void* 数组；
2、调用 backtrace_symbols_fd 将地址映射为含符号的字符串并写入日志文件；
3、在每帧符号旁附加对应帧的 source_location（需提前在每个函数入口保存至 TLS 或 ring buffer）；
4、使用 addr2line 工具配合调试信息文件解析原始地址，验证 source_location 行号与实际指令偏移的一致性。
五、启用编译器内置支持以保障可靠性
某些编译器版本对 std::source_location::current() 的行为存在差异，需明确启用标准兼容模式并禁用可能导致优化丢失位置信息的选项。
1、使用 -std=c++20 或更高标准编译，确保 std::source_location 定义可用；
2、添加 -g 生成调试信息，使 file_name() 返回真实路径而非空字符串；
3、避免启用 -frecord-gcc-switches 或 -feliminate-unused-debug-types 等干扰调试符号的选项；
4、在 Clang 中启用 -Xclang -femit-all-decls，防止模板实例化位置信息被省略。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
