Go filepath.Rel 处理绝对路径和相对路径如何统一

我在给文件索引记录生成链接时遇到过一个很典型的问题：配置里传入的是 ./docs，扫描结果却是绝对路径，直接调用 filepath.Rel 得到 error。处理方法不是手工截字符串，而是先把两个输入都统一成绝对路径，再计算相对路径。

filepath.Rel(basePath, targPath) 返回“从 basePath 走到 targPath”的相对路径。它只做词法路径计算，不访问文件系统；返回结果应当可以交给 filepath.Join(basePath, rel) 使用。只要两个参数的路径语义统一，绝对路径和相对路径就能稳定处理。

先看清 filepath.Rel 到底保证什么

官方定义的关键点是“词法等价”。例如参照目录是 /work/app，目标是 /work/app/assets/logo.svg，结果是 assets/logo.svg；目标换成 /work/shared/config.yaml，结果则是 ../shared/config.yaml。它不要求目标必须位于参照目录下。

因此，下面的关系比“字符串看起来像不像相对路径”更可靠：

rel, err := filepath.Rel(base, target)
if err != nil {
    // 计算失败时不要继续拼接，调用方需要保留原始错误。
    return "", fmt.Errorf("计算相对路径: %w", err)
}
joined := filepath.Join(base, rel)
// joined 在词法意义上与 target 等价；这里没有做 Stat 或读取文件。
_ = joined

绝对路径和相对路径混用时先统一基准

一个可靠的封装应当在入口处完成归一化。filepath.Abs 会把相对路径接到当前工作目录，并对结果做清理；如果获取当前工作目录失败，它也会返回 error。两个输入分别解析，任何一步失败都直接返回。

package main

import (
    "fmt"
    "path/filepath"
)

func relativePath(baseInput, targetInput string) (string, error) {
    // 先统一参照目录和目标路径，避免一个绝对、一个相对。
    base, err := filepath.Abs(baseInput)
    if err != nil {
        return "", fmt.Errorf("解析参照目录: %w", err)
    }
    target, err := filepath.Abs(targetInput)
    if err != nil {
        return "", fmt.Errorf("解析目标路径: %w", err)
    }
    // Rel 只计算路径关系，不代表目标文件一定存在。
    rel, err := filepath.Rel(base, target)
    if err != nil {
        return "", fmt.Errorf("计算 %q 到 %q 的相对路径: %w", base, target, err)
    }
    return rel, nil
}

例如当前工作目录是 /work/app 时，传入 ./docs 和 /work/app/docs/api.yaml，封装内部会先得到两个绝对路径，最终返回 docs/api.yaml。这里的“统一”指统一计算基准，不是把路径转换成 URL，也不是确认文件已经存在。

错误要按根目录、工作目录和路径类型拆开

最常见的失败原因有三类。第一类是参数仍然混合了绝对和相对语义；第二类是 Windows 下两个路径处在不同卷或 UNC 根；第三类是调用方其实传入了 URL、仓库内斜杠路径或容器挂载路径，却直接使用了操作系统路径函数。

Rel 不会因为目标不存在而失败，因为它不读取磁盘。相反，符号链接也不会被它解析；若业务需要真实文件系统位置，要先明确是否需要 filepath.EvalSymlinks，不能把两个函数的职责混在一起。

得到相对结果后再做一次业务复查

如果相对路径只是展示或生成索引，../ 可能完全合理；如果它要用于用户上传目录、模板目录或沙箱文件名，则通常不允许跳出基准目录。Go 1.20 起可以用 filepath.IsLocal 做词法检查：

rel, err := relativePath("./public", userPath)
if err != nil {
    // 把跨根目录等计算错误作为输入错误返回给上层。
    return err
}
if !filepath.IsLocal(rel) {
    // rel 可能包含 ..，不能直接当作 public 目录内的文件名。
    return fmt.Errorf("路径超出基准目录: %q", rel)
}
return saveUnderPublic(rel)

这个检查仍然是词法检查，不会考虑符号链接。安全边界还需要结合实际打开文件的方式、权限和链接策略设计。最后记住：本地文件路径用 filepath，URL 路径用 path；先统一语义，再统一格式，问题会少很多。

常见问题

filepath.Rel 会检查目标文件是否存在吗？

不会。它只根据路径字符串计算关系，不调用 Stat，也不会验证文件内容。

basePath 和 targPath 一个绝对、一个相对怎么办？

先对两个输入分别调用 filepath.Abs，让它们相对于同一个当前工作目录，再调用 Rel。

为什么 Rel 的结果会出现 ..？

因为目标路径在 base 的词法目录之外。展示场景可以保留；目录隔离场景则应使用 filepath.IsLocal 等规则拒绝越界结果。

URL 可以直接用 filepath.Rel 吗？

不建议。filepath 遵循操作系统分隔符，URL 统一使用斜杠，应改用 path 或 URL 专用解析方式。