Go filepath.Rel 怎样处理符号链接解析后的路径

我在整理一套带 current 符号链接的发布目录时，第一次遇到的现象是：同一个文件从逻辑目录访问和从真实发布目录访问，filepath.Rel 得到的相对结果并不一样。后来把问题拆开才发现，filepath.Rel 只负责比较两个路径字符串，它不会自动替我们解析符号链接。

需要按真实文件位置计算相对路径时，先对根目录和目标路径分别调用 filepath.EvalSymlinks，确认两者都解析成功，再把解析后的结果传给 filepath.Rel。如果目标文件还不存在，就只解析已存在的父目录。

官方文档给出的 Rel 语义是：把结果拼回根目录后，在词法上等价于目标路径；EvalSymlinks 则负责把路径中的符号链接解析出来。两者解决的是不同层次的问题。

先把逻辑路径和物理路径分开

假设发布目录如下：

/srv/app/current  ->  /srv/app/releases/v3
/srv/app/releases/v3/config/app.yaml

如果根目录使用 /srv/app/current，目标路径也使用这个逻辑前缀，那么直接调用 filepath.Rel 可能得到 config/app.yaml。这代表的是字符串层面的关系，通常已经够用。

但如果一个路径来自配置，另一个路径来自文件系统扫描，前者是 /srv/app/current，后者已经被解析成 /srv/app/releases/v3/config/app.yaml，两条路径就不在同一个坐标系里。此时不要用“多调用一次 Clean”来补救，Clean 只整理路径写法，不会跟随符号链接。

先解析两端，再调用 filepath.Rel

可以把这件事封装成一个小函数：解析阶段只做路径坐标统一，相对计算阶段只处理 Rel 的返回值。这样错误日志会保留出错阶段，也不会把解析失败伪装成“相对路径为空”。

package main

import (
	"fmt"
	"path/filepath"
)

// relativeAfterResolving 让根目录和目标路径先进入同一个物理路径坐标系。
func relativeAfterResolving(basePath, targetPath string) (string, error) {
	// 目标路径必须先解析，否则 Rel 只会比较符号链接名称。
	resolvedBase, err := filepath.EvalSymlinks(basePath)
	if err != nil {
		return "", fmt.Errorf("解析根目录 %q 失败: %w", basePath, err)
	}

	resolvedTarget, err := filepath.EvalSymlinks(targetPath)
	if err != nil {
		return "", fmt.Errorf("解析目标路径 %q 失败: %w", targetPath, err)
	}

	// Rel 只计算两个已解析路径之间的词法相对关系。
	relative, err := filepath.Rel(resolvedBase, resolvedTarget)
	if err != nil {
		return "", fmt.Errorf("计算相对路径失败: %w", err)
	}
	return relative, nil
}

func main() {
	// 这里的路径应替换成实际存在的根目录和目标文件。
	relative, err := relativeAfterResolving(
		"/srv/app/current",
		"/srv/app/current/config/app.yaml",
	)
	if err != nil {
		fmt.Println(err)
		return
	}
	fmt.Println(relative)
}

这个函数有两个重要约束：EvalSymlinks 通常要求路径中的组件真实存在；并且根目录、目标路径要用同一种解析策略。只解析目标、不解析根目录，仍然可能得到看似合法但语义错误的结果。

为什么不能只用 filepath.Clean

filepath.Clean 会合并重复分隔符、处理 . 和 ..，但它不会访问文件系统。因此下面两步的职责不同：

如果你的业务目标是“页面上展示用户传入的目录结构”，保留逻辑路径往往更合适；如果目标是“判断文件是否位于真实发布根目录下”，则应该在边界判断前解析符号链接，并对解析后的结果做后续处理。

把解析错误和 Rel 错误分开

符号链接处理出错时，最容易踩的坑是只返回一个空字符串。调用方看见空字符串，无法判断是目标文件不存在、权限不足，还是两个路径本身无法相对化。建议保留包装后的错误上下文：

// relativeExistingPath 只处理已经存在的路径，并保留失败阶段。
func relativeExistingPath(basePath, targetPath string) (string, error) {
	base, err := filepath.EvalSymlinks(basePath)
	if err != nil {
		return "", fmt.Errorf("resolve base: %w", err)
	}
	target, err := filepath.EvalSymlinks(targetPath)
	if err != nil {
		return "", fmt.Errorf("resolve target: %w", err)
	}
	rel, err := filepath.Rel(base, target)
	if err != nil {
		return "", fmt.Errorf("relativize %q from %q: %w", target, base, err)
	}
	return rel, nil
}

这里的英文错误前缀只是示例，实际项目可以统一成中文或结构化错误码。关键在于不要把 EvalSymlinks 的错误吞掉后继续把原始路径交给 Rel，否则排查时会混入两套坐标。

目标文件还不存在时怎么办

有些程序是在生成文件名或规划输出目录，目标文件此时还没有创建。直接对完整目标路径调用 EvalSymlinks，会把“尚未生成”误判成“路径解析失败”。可以只解析目标的已存在父目录，再把最后一段文件名拼回去：

// relativePlannedFile 适合计算尚未创建的输出文件相对路径。
func relativePlannedFile(basePath, targetPath string) (string, error) {
	base, err := filepath.EvalSymlinks(basePath)
	if err != nil {
		return "", fmt.Errorf("resolve base: %w", err)
	}

	// 只解析已经存在的父目录，保留尚未创建的文件名。
	targetDir, targetName := filepath.Dir(targetPath), filepath.Base(targetPath)
	resolvedDir, err := filepath.EvalSymlinks(targetDir)
	if err != nil {
		return "", fmt.Errorf("resolve target directory: %w", err)
	}
	target := filepath.Join(resolvedDir, targetName)
	rel, err := filepath.Rel(base, target)
	if err != nil {
		return "", fmt.Errorf("relativize planned file: %w", err)
	}
	return rel, nil
}

这个变体只适用于“父目录已经存在、最后一段文件名尚未创建”的规划场景。如果中间目录也可能不存在，就要先明确业务规则：是提前创建目录，还是把路径当作纯字符串处理。不要为了让函数返回成功而悄悄改变语义。

什么时候该解析，什么时候保留原路径

我现在会把选择放在调用边界，而不是在所有路径工具函数里无条件调用 EvalSymlinks：

• 做真实文件归属、根目录边界判断、发布目录比对时，解析根目录和目标路径。
• 做日志展示、用户输入回显、配置文件键匹配时，通常保留逻辑路径。
• 目标尚未创建时，解析已存在父目录，或明确采用纯词法路径规则。
• 跨平台代码不要自行拼分隔符，继续使用 filepath.Join、filepath.Rel 等平台相关 API。

最后可以用下面这张速查表决定处理方式：

常见追问

filepath.Rel 会自动跟随符号链接吗？

不会。它计算的是传入路径的词法关系，需要跟随符号链接时先调用 filepath.EvalSymlinks。

为什么两个 EvalSymlinks 都成功，Rel 仍然可能失败？

解析成功只说明路径可以得到结果；如果路径位于不同卷、不同盘符或需要当前工作目录才能确定，filepath.Rel 仍可能返回错误。

只对目标路径调用 EvalSymlinks 可以吗？

只有当根目录已经明确处于同一物理坐标系时才可以。一般工程代码更稳妥的做法是两端统一解析。

总结

filepath.Rel 解决“两个路径字符串怎样表示相对关系”，filepath.EvalSymlinks 解决“路径中的符号链接实际指向哪里”。当业务关心真实文件位置时，先解析根目录和目标路径，再计算相对路径；当目标文件还不存在时，改为解析已存在父目录。把这两个阶段分开，既能避免结果落在错误坐标系，也能让错误处理更容易维护。