std::filesystem::relative() 的第一个参数必须是目标路径（to），第二个是基准路径（from），顺序颠倒会导致错误或异常；from需为存在的绝对路径，且应先词法规整；Windows下须统一盘符大小写并确保同盘。
relative() 函数的输入顺序不能颠倒
std::filesystem::relative 的第一个参数是目标路径（to），第二个是基准路径（from）。如果写成 relative(from, to)，结果会完全错误，甚至抛出 std::filesystem::filesystem_error（常见报错：“No such file or directory” 或 “Operation not permitted”）。
它内部依赖 from 路径存在且可访问（至少能解析其父目录层级），但并不要求 to 实际存在。所以你传入一个不存在的文件路径作为 to 是合法的，但若 from 是空字符串、非法路径或不可遍历目录（如权限不足），就会失败。
- ✅ 正确：
fs::relative("/home/user/docs/report.pdf", "/home/user")→"docs/report.pdf" - ❌ 错误：
fs::relative("/home/user", "/home/user/docs/report.pdf")→ 可能返回"../.."或抛异常，逻辑反了 - ⚠️ 注意：
from必须是绝对路径；若传入相对路径（如"./src"），行为未定义，多数实现直接 throw
路径必须先 normalize 再计算 relative
如果路径含 ".."、"." 或多重斜杠（如 "/a//b/./c/../d"），relative() 不会自动规整——它基于原始字符串结构做路径树比对，容易误判公共前缀。
务必先用 fs::weakly_canonical() 或 fs::canonical()（后者要求路径存在）处理两个参数，或者至少用 fs::path::lexically_normal() 做词法规整：
立即学习“C++免费学习笔记（深入）”；
fs::path to = "/a/b/./c/../d"; fs::path from = "/a/x/y"; auto rel = fs::relative(to.lexically_normal(), from.lexically_normal()); // 安全 // to.lexically_normal() → "/a/b/d" // from.lexically_normal() → "/a/x/y" // rel → "../../b/d"
Windows 下盘符和大小写敏感性要特别处理
在 Windows 上，relative() 默认区分盘符（C: vs D:），且不忽略大小写。这意味着：
-
fs::relative("C:/foo/bar.txt", "c:/FOO")可能失败（取决于运行时库版本），因为"c:/FOO"未被自动转为大写盘符 + 标准化路径 -
fs::relative("C:/a/b", "D:/x")永远抛异常：filesystem_error，提示“paths do not share a common root”
解决方法：手动统一盘符大小写，并确认是否同盘：
fs::path from = "c:/FOO";
fs::path to = "C:/foo/bar.txt";
if (from.root_name() != to.root_name()) {
throw std::runtime_error("Cannot compute relative path across drives");
}
from = from.lexically_normal().make_preferred();
to = to.lexically_normal().make_preferred();
auto rel = fs::relative(to, from);
替代方案：自己实现更可控的 relative（适用于嵌入式或旧标准）
如果你无法确保 C++17 环境，或需要绕过 relative() 对路径存在的隐式检查（比如生成虚拟路径），可以手写一个仅做词法匹配的版本：
fs::path lexically_relative(const fs::path& to, const fs::path& from) {
auto t = to.lexically_normal();
auto f = from.lexically_normal();
auto t_it = t.begin(), f_it = f.begin();
while (t_it != t.end() && f_it != f.end() && *t_it == *f_it) {
++t_it; ++f_it;
}
fs::path result;
for (; f_it != f.end(); ++f_it) result /= "..";
for (; t_it != t.end(); ++t_it) result /= *t_it;
return result;
}
这个函数不访问文件系统，纯字符串/路径段操作，适合构建构建脚本、模板路径生成等场景。但它不处理符号链接、挂载点或跨卷限制——这些本来就是 std::filesystem::relative 的职责边界。
真正容易被忽略的是：即使所有路径都合法，relative() 在不同标准库实现（libstdc++ / libc++ / MSVC STL）中对根路径（/ vs C:/）的公共前缀判定逻辑仍有细微差异。线上服务若需强一致性，建议加一层单元测试覆盖典型路径组合。
