Path.relativize用于计算两路径间最短相对路径，核心是抵消共同前缀后用“..”回退再拼接剩余部分；需先规范化路径，推荐转为绝对路径操作，不检查文件存在性或符号链接。
Path.relativize 是 Java NIO.2 中 java.nio.file.Path 接口提供的一个方法，用于计算从一个路径（起点）到另一个路径（目标）的**相对路径**。它不涉及文件系统实际存在性，只做纯路径字符串的逻辑推导，核心是“抵消共同前缀，用 .. 回退 + 剩余部分拼接”。
理解 relativize 的基本逻辑
relativize(a, b) 实际上是：从路径 a 出发，如何用最短的相对路径抵达路径 b。其本质是：
- 找出
a和b的最长公共祖先路径（即共同前缀） - 从
a往上回退到该祖先（每级用一个..） - 再从该祖先向下走到
b的剩余部分
例如：/a/b/c relativize /a/d/e → 公共前缀是 /a，/a/b/c 需先回退两级到 /a（即 ../..），再进入 d/e → 结果为 ../d/e。
使用时的关键注意事项
relativize 是路径对象间操作，不是字符串拼接。必须确保两个 Path 都已规范化（避免 ./、../、重复斜杠干扰）：
- 建议对输入路径先调用
.toAbsolutePath().normalize()，尤其当路径来自用户输入或配置时 - 若任一路径为相对路径，relativize 仍可工作，但结果依赖于当前工作目录的隐含上下文，易出错；推荐统一转为绝对路径再计算
- relativize 不检查文件是否存在，也不处理符号链接——它只做纯路径代数运算
典型代码示例（Java）
假设你有两个文件变量：
Path from = Paths.get("/home/user/project/src/main/java");
Path to = Paths.get("/home/user/project/target/classes");
Path relative = from.relativize(to);
System.out.println(relative); // 输出：../../target/classes
若路径含变量（如 String base = "/opt/app"），应先构造 Path 对象再调用：
Path from = Paths.get(base, "config", "app.conf")Path to = Paths.get(base, "logs", "error.log")-
Path rel = from.relativize(to)→../logs/error.log
常见陷阱与规避方式
容易出错的情况包括：
-
跨根目录无法 relativize：如
C:\a和D:\b（Windows）或/a和/home/b（Linux 下若不在同一挂载点且无共同前缀）→ 抛IllegalArgumentException。应提前判断是否同根或捕获异常 -
结尾斜杠影响结果：Path 构造时
"dir"和"dir/"被视为不同路径（后者隐含“目录”语义），可能导致公共前缀计算偏差。统一用.resolve("")或.toRealPath()标准化 -
未处理 null 或空路径：务必校验输入非 null，且
.toString()非空字符串
