Go filepath.Rel 遇到不同根目录时怎样判断路径不可计算

如果 filepath.Rel 返回错误，先不要把原因简单归结为“两个目录没有共同父目录”。它本来就能把 /srv/app 和 /var/cache 转换成 ../var/cache。真正需要优先排查的是：一个输入是绝对路径、另一个是相对路径，或者在 Windows 上两个路径属于不同卷。

实用判断可以分成两层：先用 filepath.IsAbs 和 filepath.VolumeName 检查根路径语义，再调用 filepath.Rel 处理正常的目录层级差异。这样既不会误报合法的 ..，也不会把错误吞掉后继续拼接一个看似可用的文件名。

先分清“没有共同目录”和“不能相对化”

filepath.Rel(basePath, targPath) 的目标是返回一个相对 basePath 的路径，使它与 basePath 连接后在词法上等价于 targPath。因此，两个路径没有共同的子目录并不构成失败条件。

例如，下面的两个绝对路径都以 Unix 根目录 / 为根。虽然它们的目录分支完全不同，返回的 ../var/cache/app.db 仍然是合法结果：

package main

import (
	"fmt"
	"path/filepath"
)

func main() {
	// 没有共同子目录，但两个输入都以同一个根目录开头。
	rel, err := filepath.Rel("/srv/app", "/var/cache/app.db")
	if err != nil {
		// 不要把错误结果当作可用路径继续写入归档或配置。
		fmt.Println("计算失败:", err)
		return
	}
	fmt.Println(rel) // 输出：../../var/cache/app.db
}

相反，绝对路径和相对路径混在一起时，Go 无法仅凭两个字符串确定相对路径的参照工作目录，Rel 会返回错误。这个判断与“目录是否存在”无关，Rel 是词法路径计算，不会替你访问文件系统。

用 IsAbs 找出绝对路径与相对路径混用

归档、文件索引和构建缓存通常应该先把输入统一成绝对路径；如果业务必须保留相对路径，也要明确要求两个输入采用同一种语义。下面的包装函数把这个约束写在调用边界上：

package main

import (
	"fmt"
	"path/filepath"
)

// relativePath 只接受同为绝对或同为相对的两个路径。
func relativePath(basePath, targPath string) (string, error) {
	baseAbs := filepath.IsAbs(basePath)
	targAbs := filepath.IsAbs(targPath)
	if baseAbs != targAbs {
		// 混用时需要当前工作目录，不能静默猜测参照点。
		return "", fmt.Errorf("basePath 和 targPath 不能混用绝对/相对路径")
	}

	rel, err := filepath.Rel(basePath, targPath)
	if err != nil {
		// 保留标准库错误，方便上层记录输入边界。
		return "", fmt.Errorf("filepath.Rel: %w", err)
	}
	return rel, nil
}

func main() {
	// 这组输入的绝对性不同，函数会在 Rel 前直接拒绝。
	rel, err := relativePath("/srv/app", "var/cache/app.db")
	fmt.Printf("rel=%q err=%v\n", rel, err)
}

如果输入来自用户、配置文件或不同模块，统一绝对路径的方式通常是先分别调用 filepath.Abs，然后再计算相对路径。但 Abs 会使用当前工作目录，所以应在应用启动时固定工作目录语义，不能把它当成跨机器一致的路径转换器。

Windows 上还要检查 VolumeName

Windows 路径的“根”不只是一条反斜杠，还包含盘符或 UNC 共享名。filepath.VolumeName 会提取这些卷信息：例如 C:\work\a.txt 的卷名是 C:，而 \\server\share\a.txt 的卷名是 \\server\share。

不同卷之间没有一个可由 .. 表达的共同祖先，因此跨卷计算应在业务层给出清晰错误。注意：在非 Windows 系统上，VolumeName 对普通 Unix 路径返回空字符串；不要在 Linux 上用 Windows 字符串格式模拟跨盘测试并据此推断 Windows 行为。

package main

import (
	"fmt"
	"path/filepath"
	"strings"
)

// portableRel 在调用 Rel 前拒绝不同卷，避免生成跨卷的假相对路径。
func portableRel(basePath, targPath string) (string, error) {
	baseVolume := filepath.VolumeName(basePath)
	targVolume := filepath.VolumeName(targPath)
	if !strings.EqualFold(baseVolume, targVolume) {
		// Windows 的盘符比较不应受大小写影响；空卷名表示当前平台没有卷前缀。
		return "", fmt.Errorf("路径位于不同卷: %q 与 %q", baseVolume, targVolume)
	}
	if filepath.IsAbs(basePath) != filepath.IsAbs(targPath) {
		// 两个输入必须共享绝对或相对语义。
		return "", fmt.Errorf("路径根语义不一致")
	}

	// 同一卷、同一种根语义下，合法的 .. 由标准库正常返回。
	return filepath.Rel(basePath, targPath)
}

func main() {
	// 这里使用 Windows 形态的示例输入；实际结果应在对应平台语义下判断。
	rel, err := portableRel(`C:\work\app`, `D:\cache\app.db`)
	fmt.Printf("rel=%q err=%v\n", rel, err)
}

不要把 Rel 的结果当成文件系统验证

filepath.Rel 只处理路径字符串。它不会判断目标是否存在，也不会解析符号链接，更不会证明生成的相对路径一定没有越出某个目录。若业务目标是限制访问范围，应在路径计算之后再设计独立的目录边界策略；如果目标是解析真实文件位置，则需要另行考虑 EvalSymlinks 和权限错误。

对归档条目、URL 路径和本地文件路径也要选择正确的包：本地操作系统路径使用 path/filepath；始终使用正斜杠的 URL 或归档内部路径使用 path。不要为了让分隔符看起来统一，就把 filepath.Rel 直接用于 URL。

一张表决定是否调用 filepath.Rel

常见问题

两个绝对路径没有共同父目录，为什么还能成功？

只要它们在同一个根语义下，Rel 可以用一个或多个 .. 回到共同根，再进入目标目录。是否存在共同的具体目录，不是成功条件。

调用前要不要先判断文件存在？

不需要。Rel 是词法计算；如果业务还要求文件存在，应在相对路径计算之外单独处理 os.Stat 等文件系统操作。

怎样让不同机器生成的相对路径一致？

先约定路径的语义：本地文件路径跟随运行平台，URL/归档路径统一使用正斜杠；同时固定基准目录的来源，不要让隐含的当前工作目录决定输出。

总结一下：filepath.Rel 不怕没有共同子目录，真正要拦截的是绝对性不一致和 Windows 不同卷。先用 IsAbs、VolumeName 做清晰的前置判断，再保留 Rel 的错误，路径处理就能从“猜结果”变成可解释的跨平台规则。