Go filepath.Rel 在不同 Windows 盘符之间为什么会报错

在 Windows 上，filepath.Rel 不能把 C:\\work 和 D:\\cache 这样的路径变成一个可靠的相对路径，因为两个路径不属于同一个卷。这个错误不是盘符大小写或斜杠写法导致的，而是相对路径本身没有跨越卷边界的表达能力。

官方资料：https://pkg.go.dev/path/filepath#Rel

Rel 适合处理同一卷内的词法相对路径。调用前先用 filepath.VolumeName 比较卷名；同卷才计算相对路径，跨卷则按业务契约返回绝对路径、映射后的逻辑路径或明确错误。

为什么不同盘符无法得到相对路径

filepath.Rel(basePath, targPath) 的目标是返回一个路径，使它和 basePath 拼接后在词法上等价于 targPath。在同一个 Windows 卷里，可以用 .. 回到共同目录；但从 C: 回到 D: 并不存在这样的相对组件。

因此，问题的判断点不是“两个字符串看起来像不像”，而是它们的卷名是否一致。filepath.VolumeName 在 Windows 上会取出类似 C: 的卷名；UNC 路径则会取出类似 \\\\server\\share 的共享卷名。

先比较 VolumeName，再调用 Rel

把卷名比较封装在一个小函数里，可以让调用方明确区分“没有相对路径”和“相对路径计算成功”。不要在错误时直接返回空字符串，否则上层很容易把空路径当成当前目录或缺省值继续使用。

package main

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

// relativeOnSameVolume 只负责同卷相对路径，跨卷时保留错误语义。
func relativeOnSameVolume(basePath, targetPath string) (string, error) {
    baseVolume := filepath.VolumeName(basePath)
    targetVolume := filepath.VolumeName(targetPath)

    // Windows 盘符和 UNC 共享名是相对路径的边界。
    if !strings.EqualFold(baseVolume, targetVolume) {
        return "", fmt.Errorf("different volumes: %q and %q", baseVolume, targetVolume)
    }

    // Rel 仍可能因相对/绝对路径混用等原因失败，不能忽略 err。
    rel, err := filepath.Rel(basePath, targetPath)
    if err != nil {
        return "", fmt.Errorf("make relative path: %w", err)
    }
    return rel, nil
}

这里的 EqualFold 只用于比较卷名的大小写差异；它不负责清理路径，也不替代 Rel 自身的错误处理。若运行环境不是 Windows，Windows 盘符字符串不会被当前操作系统的 filepath 当成真实卷名，测试应放在目标平台或使用平台专门的测试输入。

同盘可以算相对路径，跨盘要换返回策略

同盘场景可以继续使用 Rel。例如基准目录是 C:\\work\\app，目标是 C:\\work\\app\\assets\\logo.png，结果就是 assets\\logo.png。这个结果适合写入同一工作区内的索引、日志或配置。

跨盘场景没有唯一的“修复写法”，要先看调用方要的是什么：

• 如果调用方必须得到可直接访问的文件位置，保留目标的绝对路径，并明确它不是相对路径。
• 如果业务需要稳定的逻辑地址，把两个卷映射到同一个应用根目录，再对映射后的路径调用 Rel。
• 如果跨卷本身代表配置错误或越权边界，返回带原因的错误，让上层提示或终止任务。

// resolveAsset 约定：同卷返回相对路径，跨卷返回可识别的业务错误。
func resolveAsset(root, asset string) (string, error) {
    rel, err := relativeOnSameVolume(root, asset)
    if err != nil {
        // 上层可以据此选择绝对路径或提示用户调整工作区。
        return "", fmt.Errorf("asset is outside the workspace: %w", err)
    }
    return rel, nil
}

测试时覆盖卷边界和错误契约

跨平台代码不要只在 macOS 或 Linux 上测试一组斜杠路径。至少应在 Windows 上覆盖同盘成功、不同盘失败、UNC 同共享成功，以及混用相对路径时的错误返回。测试的重点是调用方契约：失败时有错误，成功时结果仍是相对路径。

func TestRelativeOnSameVolume(t *testing.T) {
    // 这些路径只用于 Windows 测试，避免把盘符语义带到 Unix。
    if runtime.GOOS != "windows" {
        t.Skip("Windows volume semantics are required")
    }

    got, err := relativeOnSameVolume(`C:\\work\\app`, `C:\\work\\app\\assets`)
    if err != nil || got != `assets` {
        t.Fatalf("same volume: got %q, err %v", got, err)
    }

    // 不同盘符必须失败，不能伪造一个带 .. 的相对路径。
    if _, err := relativeOnSameVolume(`C:\\work`, `D:\\cache`); err == nil {
        t.Fatal("different volumes should return an error")
    }
}

归纳起来，filepath.Rel 报错时先问“两个路径是否属于同一个卷”，再问“调用方希望得到哪一种地址”。卷名不同就不能靠多加几个 .. 解决；要么保留绝对路径，要么先建立统一的逻辑根，要么把跨卷作为明确错误处理。

常见问题

filepath.Clean 能消除跨盘符错误吗？

不能。Clean 只做词法清理，不会把不同卷变成同一个卷。

把 Windows 路径改成斜杠就能调用 Rel 吗？

不能保证。分隔符格式和卷边界是两件事，跨盘符仍然无法构造相对路径。

可以在错误时返回目标路径吗？

可以，但应在函数文档和返回类型中明确这代表“绝对路径兜底”，不要让调用方误以为它一定是相对路径。