Go filepath.Rel 怎样计算两个路径的相对关系

在文件扫描、资源定位或目录迁移时，我们经常拿到两个完整路径，却需要把它们转换成“从某个目录出发，怎样走到目标”的短路径。Go 的 filepath.Rel 正是做这件事的：传入基准路径 basePath 和目标路径 targPath，得到一个相对结果。它按当前操作系统的路径规则做词法计算，不会替你检查文件是否存在。

官方文档：https://pkg.go.dev/path/filepath#Rel

filepath.Rel(basePath, targPath) 的参数顺序不能反：第一个是“从哪里出发”，第二个是“要到哪里”。正常返回的相对路径可以和 filepath.Join(basePath, rel) 组合，得到词法上等价的目标路径。

参数顺序先固定：basePath 与 targPath

先把一个资源目录定位场景写清楚：基准目录是 /srv/app，目标文件是 /srv/app/assets/logo.svg。此时结果应该是 assets/logo.svg，而不是把基准目录本身再写进结果。第一个参数决定相对关系的起点，第二个参数决定终点。

package main

import (
	"fmt"
	"path/filepath"
)

func main() {
	basePath := "/srv/app"
	targPath := "/srv/app/assets/logo.svg"

	// 第一个参数是相对计算的起点，第二个参数是目标路径。
	rel, err := filepath.Rel(basePath, targPath)
	if err != nil {
		fmt.Println("计算相对路径失败:", err)
		return
	}

	// 组合回去用于比较或生成资源路径；Rel 本身不访问文件系统。
	rebuilt := filepath.Join(basePath, rel)
	fmt.Println("relative:", rel)
	fmt.Println("rebuilt:", rebuilt)
}

这个组合关系也是很实用的检查思路：如果业务只想得到一个资源标识，就保存 rel；如果要确认关系拼接是否符合预期，可以再用 Join 组合回去。不要用字符串替换目录前缀代替它，因为前缀相同不代表路径边界相同。

同目录、子目录和返回上级怎么读

当目标在基准目录下面，返回值就是剩余的子路径；当目标在基准目录的旁支，结果会包含一个或多个 ..。例如从 /srv/app/config 到 /srv/app/assets/logo.svg，结果是 ../assets/logo.svg；这表示先退出 config，再进入 assets。

Rel 返回的是相对路径，不是带当前目录的绝对路径。它也会对结果做清理，所以业务不需要再用字符串拼接处理斜杠。对于 URL 或固定使用正斜杠的资源标识，应考虑 path 包；filepath 适合操作系统文件路径。

把错误当作输入边界处理

filepath.Rel 不是“任何两个字符串都能算”。官方说明明确提到：如果目标无法相对化，或者计算过程需要知道当前工作目录，就会返回错误。最容易踩到的情况是一个路径绝对、另一个路径相对；在 Windows 上，两个绝对路径属于不同盘符或卷，也不能直接得到跨卷的相对结果。

package main

import (
	"fmt"
	"path/filepath"
)

func relativePath(basePath, targPath string) (string, error) {
	// 让 filepath.Rel 根据当前平台处理分隔符、卷名和 .. 关系。
	rel, err := filepath.Rel(basePath, targPath)
	if err != nil {
		// 保留原始错误，调用方才能区分输入边界和后续文件错误。
		return "", fmt.Errorf("无法计算 %q 到 %q 的相对路径: %w", basePath, targPath, err)
	}
	return rel, nil
}

func main() {
	// 两个绝对路径属于同一棵路径树，适合直接计算。
	rel, err := relativePath("/srv/app", "/srv/app/config/app.yaml")
	if err != nil {
		fmt.Println("路径输入有问题:", err)
		return
	}
	fmt.Println("相对路径:", rel)
}

排查时先把输入规范统一：同一批路径尽量先确定是绝对路径还是相对路径，再确认它们属于同一文件系统路径树。不要捕获错误后直接返回空字符串，否则上层很容易把“无法计算”误当成“目标就在基准目录”。

不要把 Rel 当成安全校验

Rel 只做词法上的路径关系计算。它不会读取符号链接，也不会判断目标是否存在、是否可读，更不会替你决定结果是否允许访问。比如结果中出现 ..，只说明目标在基准目录之外；是否允许继续拼接，需要由业务的目录边界和权限策略决定。

如果路径来自用户输入，应该把“计算相对关系”和“允许访问”拆开处理：先根据业务要求统一路径形式，再判断结果是否符合目录范围，最后才进行文件打开或目录遍历。不要因为 Rel 返回了一个字符串，就把它当成已经通过安全检查。

用小函数统一路径转换

项目里通常不需要到处直接调用 filepath.Rel。把错误上下文和参数命名集中在一个小函数里，调用方会更容易记录“从哪个根目录计算到哪个目标”，测试也能覆盖同目录、子目录、旁支和非法输入。

func mustRelative(basePath, targPath string) (string, error) {
	// 统一返回相对路径；不在这里偷偷检查文件是否存在。
	rel, err := filepath.Rel(basePath, targPath)
	if err != nil {
		return "", fmt.Errorf("base=%q target=%q: %w", basePath, targPath, err)
	}
	return rel, nil
}

最终可以按四点记忆：第一个参数是起点，第二个参数是目标；子目录返回剩余路径，旁支会出现 ..；相对输入、不同卷和无法统一的路径要处理错误；词法相对化不等于文件存在性或访问安全校验。

常见问题

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

不会。它计算的是路径字符串之间的词法关系，文件是否存在要由后续文件操作判断。

为什么结果里会出现 ..？

说明目标不在基准目录的子树中，需要先从基准目录返回上级，再进入目标所在的旁支。

filepath.Rel 和 path.Rel 有什么区别？

filepath.Rel遵循操作系统文件路径规则；处理 URL、归档内路径等固定使用正斜杠的名称时，应使用 path 包的规则。

两个路径一个绝对一个相对怎么办？

先在业务边界统一路径形式，或者明确当前工作目录，再调用 Rel；不要忽略返回的错误。