std::filesystem::relative(to, from) 返回从 from 到 to 的相对路径，前提为两路径需同卷、存在（或父目录存在）、已标准化且均为绝对路径；顺序颠倒、跨盘符或相对路径作 base 均导致错误。
std::filesystem::relative 的基本用法和前提条件
必须确保两个路径都存在（或至少父目录存在），否则 std::filesystem::relative 会抛出 std::filesystem::filesystem_error。它不是纯字符串运算，而是基于实际目录结构解析的——这点常被忽略，导致本地测试通过、CI 环境失败。
调用前建议先用 std::filesystem::exists() 或 std::filesystem::is_directory() 做轻量校验：
if (!std::filesystem::exists(from) || !std::filesystem::exists(to)) {
throw std::runtime_error("path not found");
}
from 和 to 参数顺序不能颠倒
std::filesystem::relative(to, from) 返回的是“从 from 出发，到达 to 所需的相对路径”——这个语义和 shell 中 realpath --relative 一致，但和直觉相反（容易写成 relative(from, to)）。
常见错误现象：../foo 变成 ../../foo 或空字符串，多半是参数顺序错了。
立即学习“C++免费学习笔记（深入）”；
-
from = "/a/b/c"，to = "/a/d/e"→ 结果是"../../d/e" -
from = "/a/b/c"，to = "/a/b/c/x/y"→ 结果是"x/y" -
from = "/a/b"，to = "/a/b"→ 结果是"."（不是空字符串）
跨盘符或跨文件系统时会失败
Windows 下，from = "C:/x" 和 to = "D:/y" 直接调用 relative 会抛异常；Linux 下若 from 和 to 分属不同挂载点（如 /mnt/usb 和 /home），同样不支持。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
此时函数无法推导公共祖先，返回值无意义。不要试图捕获异常后 fallback 到字符串拼接——路径规范化逻辑完全不同，std::filesystem::path 的 lexically_normal() 不等价于 relative()。
实操建议：
- 先用
std::filesystem::path::has_root_name()和has_root_directory()检查是否同根 - 对 Windows，比较
root_path()是否相等；对 Unix，可用statfs()或statvfs()判断是否同一设备（但通常直接拒绝更安全）
结果中不包含尾部斜杠，且不处理 symbolic link
std::filesystem::relative 默认按物理路径解析（类似 readlink -f 后计算），遇到软链会自动展开。如果需要逻辑路径（保留 symlink 层级），C++20 标准不支持——得自己遍历 parent_path() 并逐段比对 filename()，再拼 ".."。
另外注意：即使 to 是目录，结果也不会自动加 trailing slash。需要时手动追加：
auto rel = std::filesystem::relative(to, from);
if (std::filesystem::is_directory(to)) {
rel /= ""; // 等价于 rel += "/"
}
Windows 路径分隔符自动转为 /（除非显式调用 make_preferred()），但输出始终是正斜杠风格，别指望它输出 ..\..\d\e。
最易被忽略的一点：当 from 是相对路径（如 "./src"）时，relative() 会先将其相对于当前工作目录展开——行为取决于运行时 getcwd()，不是编译时路径。务必确认上下文 cwd 是否稳定。
