std::source_location 不能自动对齐分布式 trace，必须配合 OpenTelemetry 的 SpanContext 才能实现日志与链路的行级匹配；其位置信息仅在调用点注入才准确，跨平台需裁剪文件名且禁用 function_name()。
std::source_location 不能自动对齐分布式 trace，它只提供编译期快照，必须配合 OpenTelemetry 等 SDK 提取的运行时 SpanContext 才能实现日志与链路的行级匹配。单独用它打日志，跨平台下大概率出现所有日志都指向 logging.cpp:23、文件路径炸长、函数名为空或乱码。
为什么 log("msg") 总显示 logging.cpp:23 而不是真实业务行
因为 std::source_location::current() 是 consteval 函数，它“看到”的永远是它被求值的那一行。常见错误包括：
- 在日志函数体内调用：
auto loc = std::source_location::current()→ 固定返回该函数定义行 - 用宏封装但宏里显式写
std::source_location::current()→ 位置塌缩到宏定义行 - 提前保存为类成员或静态变量 → 所有日志复用初始化点位置
正确姿势只有一种：参数带默认值，且调用时不传参。
void log(const char* msg, const std::source_location& loc = std::source_location::current());
调用时写 log("timeout")，编译器会在每一处调用点自动注入真实位置。
立即学习“C++免费学习笔记（深入）”；
跨平台短文件名裁剪必须在调用点完成
loc.file_name() 返回的是构建时绝对路径，Linux/macOS 是 /home/user/src/core/db.cpp，Windows 是 C:projsrccoredb.cpp，CI 构建路径深度还可能更深。直接输出会导致日志膨胀、grep 困难、服务端解析失败。
- 裁剪不能放在 logger 实现里统一做——分布式节点间路径结构不一致（CI 构建路径 vs 容器挂载路径）
- 推荐用
std::filesystem::path(loc.file_name()).filename().c_str()，语义清晰、C++17 起可用、自动处理分隔符 - 若追求零开销且只跑 Linux/macOS：
strrchr(loc.file_name(), '/')后取子串；Windows 需额外判'\' - 禁止用
std::string构造再.substr()—— 高频日志下堆分配不可接受
function_name() 在 GCC/Clang/MSVC 上根本不可信
不同编译器对 loc.function_name() 的实现差异极大：
- GCC 默认返回空字符串
"" - Clang 返回带签名的完整声明
"void handle_request()" - MSVC 返回修饰名
"?handle_request@@YAXXZ"，无法跨语言匹配
因此：
- 禁用
function_name()作为 trace tag 字段（如 span 属性中的"function"） - 统一使用
file_name()与line()组合——二者在 GCC/Clang/MSVC 下均稳定返回非空字符串与有效整数 - 若需函数标识，改用编译期宏
__func__或__FUNCTION__，并确保所有平台启用-fno-omit-frame-pointer或等效调试信息生成选项
log_with_trace 必须和 SpanContext 绑定在同一调用点
std::source_location 不是 trace 上下文载体，它没有 trace_id、span_id、时间戳，也不支持序列化。它的唯一可靠用途，是在已有 trace 链路中为日志打锚点。
- 日志函数签名必须显式接收
const opentelemetry::trace::SpanContext&参数 - 调用时直接写
log_with_trace("timeout", current_span_context())，不传第三个参数 - 避免中间封装层（如
Logger::write()）截断调用链，否则位置信息会漂移到封装层 - 提取
trace_id应调用ctx.trace_id().to_string()，拼接格式建议为[{trace_id}][{short_file}:{line}] {msg}
最易被忽略的一点：所有裁剪、拼接、提取操作都必须发生在调用点，而不是 logger 实现内部——否则分布式节点间路径结构不一致，日志和 trace 就永远对不上。
