path/filepath Rel 判断相对路径时如何处理不同卷名

如果程序需要把一个文件路径转换成相对于目录的路径，filepath.Rel 的关键前提不是“两个字符串看起来都像绝对路径”，而是它们必须处在同一个可比较的路径根下。Windows 的盘符和 UNC 共享名会参与这个判断；Unix 路径没有卷名，通常只比较根路径属性。

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

Rel 做的是词法计算：把结果交给 filepath.Join(base, rel) 后，应与目标路径在词法上等价。若两个路径的卷名或根路径属性不一致，应保留错误，不要把它强行改写成一个看似可用的相对路径。

• 同一 Windows 盘符：可以继续计算目录层级。
• 不同 Windows 盘符：不存在可靠的相对路径，Rel 返回错误。
• UNC 路径：服务器与共享名组成卷名，不能把不同共享当成同一棵目录树。
• Unix 路径：VolumeName 返回空字符串，但绝对路径与相对路径的根属性仍要一致。

变化一句话：Rel 会先比较卷名和根属性

filepath.Rel(basePath, targPath) 返回一个相对路径，并保证把它接到 basePath 后，词法上等价于 targPath。这句话里的“词法”很重要：它不访问文件系统，也不解析符号链接；文章只讨论输入路径本身的卷名和根属性。

实现层面会分别取得两个输入的 VolumeName，再比较去掉卷名后的路径是否都带有根分隔符。如果一个是根路径、另一个不是，或者两个卷名不同，就不能安全地拼出同一棵路径树中的 ..。

为什么 VolumeName 是跨平台判断的入口

VolumeName 返回路径开头的卷名。在 Windows 上，C:\\work\\app 的卷名是 C:；\\\\server\\share\\dir 的卷名是 \\\\server\\share。在其他平台上，它返回空字符串。因此，不能把 Windows 盘符或 UNC 共享名当成普通目录名再交给字符串比较。

package main

import (
	"fmt"
	"path/filepath"
)

func describe(path string) {
	// VolumeName 只负责识别平台定义的卷前缀，不会解析符号链接。
	volume := filepath.VolumeName(path)
	// IsAbs 与卷名是两个维度：盘符存在不代表路径一定带根分隔符。
	fmt.Printf("path=%q volume=%q absolute=%v\n", path, volume, filepath.IsAbs(path))
}

func main() {
	// 这些字符串用于说明不同平台的输入形状，不把某个平台的结果冒充成本机运行结果。
	for _, path := range []string{
		`C:\\work\\app`,
		`\\\\server\\share\\app`,
		`/var/lib/app`,
	} {
		describe(path)
	}
}

还要注意 C: 与 C:\\ 的语义不同：前者是当前驱动器目录语境，后者才是盘符根目录。路径转换函数应保留输入语义，不能只截取字符串前缀后自行拼接。

同卷、不同卷和 UNC 路径分别怎么处理

可以把判断分成三类。第一类是同一盘符，例如基准路径在 C:\\work，目标路径在 C:\\work\\src，两者卷名同为 C:，结果可以是 src。第二类是不同盘符，例如 C: 与 D:，二者没有共同的相对路径根，返回错误是正确行为。

第三类是 UNC 路径。\\\\server\\share\\a 与 \\\\server\\share\\b 共享同一个卷名，可以继续比较目录层级；如果共享名不同，即使服务器名相同，也不应把它们当作同一卷。Unix 上卷名都为空，但 /srv/app 与 srv/app 仍然分别是绝对路径和相对路径，根属性不一致同样会失败。

package main

import (
	"fmt"
	"path/filepath"
)

func relative(base, target string) {
	// 直接保留 Rel 的错误，让调用方决定是否改用绝对路径或提示用户。
	rel, err := filepath.Rel(base, target)
	if err != nil {
		fmt.Printf("base=%q target=%q: 无法计算相对路径：%v\n", base, target, err)
		return
	}
	fmt.Printf("base=%q target=%q rel=%q\n", base, target, rel)
}

func main() {
	// 这些案例用于展示输入边界；Windows 字符串不会在 Unix 上被解释成 Windows 路径。
	relative(`C:\\work`, `C:\\work\\src`)
	relative(`C:\\work`, `D:\\data`)
	relative(`/srv/app`, `/srv/app/bin`)
}

迁移建议：先检查卷名，再把 Rel 错误传出去

如果业务允许用户同时提交不同平台的路径，最稳妥的策略是把路径关系判断封装成一个小函数：先比较卷名，再调用 Rel，并保留 Rel 对根属性的最终判断。不要用 strings.TrimPrefix、替换盘符或把反斜杠统一成斜杠来“修复”错误，那些做法会丢失平台语义。

package pathutil

import (
	"fmt"
	"path/filepath"
)

func SafeRel(base, target string) (string, error) {
	baseVolume := filepath.VolumeName(base)
	targetVolume := filepath.VolumeName(target)
	// 先给出更明确的跨卷错误，避免把业务错误混同为目录层级问题。
	if baseVolume != targetVolume {
		return "", fmt.Errorf("不同卷名：base=%q target=%q", baseVolume, targetVolume)
	}
	// Rel 仍负责判断绝对/相对根属性，并清理词法结果。
	return filepath.Rel(base, target)
}

这段封装不是为了替代 Rel，而是把“不同卷”变成更容易记录和展示的业务错误。若目标是生成跨平台配置文件，另一种更清晰的选择是保存原始绝对路径或把卷名作为独立字段，而不是假设任何路径都能转换成相对路径。

常见问题

不同盘符为什么不能返回 ../../data？

因为 .. 只能在同一棵路径树中回退，不能从一个 Windows 卷跳到另一个卷。返回错误比生成不可用路径更安全。

VolumeName 为空是不是说明路径没有根？

不一定。Unix 路径的卷名前缀就是空字符串，/tmp/a 仍然是绝对路径；还要结合 filepath.IsAbs 判断根属性。

Rel 会不会解析符号链接？

不会。它进行词法处理。如果业务需要真实文件系统目标关系，应另行设计符号链接解析和错误处理，不要把结果归因于 Rel 的卷名比较。

总结：把 VolumeName 当作平台边界信号，把 Rel 当作同一根路径内的词法关系计算；同卷继续计算，跨卷保留错误，Unix 则同时关注空卷名与绝对/相对根属性。