Go filepath.Rel 兼容 Windows VolumeName

Go 的 filepath.Rel 在 Windows 上已经识别盘符和 UNC 共享卷名。兼容 Windows 的关键是保留完整输入、明确路径属于哪个操作系统，并处理无法计算相对路径的错误。同一盘符或同一 UNC 共享中的完整绝对路径可直接交给它；不同盘符、不同共享之间不能靠删掉卷名制造相对路径。

官方地址：https://pkg.go.dev/path/filepath

最小写法是先约束两端为本机完整绝对路径，再调用 filepath.Rel(base, target) 并检查 err。下面把一种常见的字符串拼接写法改为保留路径语义的封装；这属于业务写法调整，并不是 Go 新版本增加了某项语义。

本地路径需要保留卷与根目录语义

考虑把素材文件记录成相对于项目目录的位置。Windows 输入 C:\studio\assets\logo.png 同时包含卷名、根目录以及文件层级。VolumeName 在 Windows 上提取到的是 C:；对 \\filesrv\design\assets\logo.png，它提取的是 \\filesrv\design，包含服务器名与共享名。

卷名存在不代表路径已经完整绝对化。C:assets\logo.png 是盘符相对路径，依赖 C 盘的当前目录；\assets\logo.png 只有当前卷的根目录信息，也没有明确盘符。本例接口主动拒绝这两类输入，避免业务记录随着运行环境变化。Rel 本身可以处理部分兼容的相对路径，本例的绝对路径约束是额外的接口约定。

删盘符再拼接会丢失哪些信息

旧写法常把两端的 VolumeName 删去，再计算剩余文本。这样 C:\studio 与 D:\assets 看起来只剩两个根目录下的层级，原本无法跨越的卷边界被抹掉。对 UNC 路径只删服务器名也有同样问题：design 与 archive 是不同共享，不能当成一个共享里的普通目录。

另一种做法是按字符串前缀截取项目目录。它没有表达完整的目录层级规则，容易把名字相近的目录混为一谈，也没有覆盖 Windows 大小写比较与分隔符语义。保留卷名并不意味着自己复制标准库内部算法；业务层只需把完整路径传进去。

用完整绝对路径计算相对位置

下面的原创示例只计算路径文本，不打开文件。NativeRelAbs 用 IsAbs 约束输入，将 Rel 的错误用 %w 保留下来。它不预先用字符串相等比较两端卷名，也不在失败后悄悄改为返回目标绝对路径。

package main

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

// NativeRelAbs 只接受当前运行系统的完整绝对路径。
func NativeRelAbs(base, target string) (string, error) {
    if !filepath.IsAbs(base) || !filepath.IsAbs(target) {
        return "", fmt.Errorf("需要本机完整绝对路径")
    }
    // 保留卷名；跨卷或不兼容路径交给标准库返回错误。
    rel, err := filepath.Rel(base, target)
    if err != nil {
        return "", fmt.Errorf("相对路径计算失败: %w", err)
    }
    return rel, nil
}

func main() {
    // Windows 字面量用原始字符串；非 Windows 不解释这些用例。
    if runtime.GOOS != "windows" {
        fmt.Println("这些用例应在 Windows 上运行")
        return
    }
    cases := []struct{ base, target string }{
        {`C:\studio`, `C:\studio\assets\logo.png`},
        {`C:\studio`, `D:\assets\logo.png`},
        {`\\filesrv\design\studio`, `\\filesrv\design\assets\logo.png`},
        {`\\filesrv\design\studio`, `\\filesrv\archive\logo.png`},
        {`C:\studio`, `C:assets\logo.png`},
    }
    for _, c := range cases {
        rel, err := NativeRelAbs(c.base, c.target)
        if err != nil {
            // 错误分支不把空字符串当成可用路径。
            fmt.Printf("base=%q target=%q err=%v
", c.base, c.target, err)
            continue
        }
        fmt.Printf("base=%q target=%q rel=%q
", c.base, c.target, rel)
    }
}

这里无需文件句柄，也就没有 Close 资源回收步骤。错误处理中保留输入上下文有助于定位配置问题；实际业务日志若涉及用户目录，应按应用日志策略控制展示范围。示例尚未作为运行结果执行，后面的表格是按接口语义推导的预期行为。

用 Windows 用例说明兼容范围

如果两端表示同一路径，成功结果可能是 .，应由业务决定是否允许。结果含 .. 也不必然是计算错误：它可能只是目标位于项目目录之外。若业务只接受项目内资源，还要单独制定允许范围，不能把“相对路径计算成功”解释为“允许访问”。

Linux 服务如何处理 Windows 路径文本

filepath 使用程序目标操作系统的路径规则。在 Linux 或 macOS 上，对 Windows 路径字符串调用 VolumeName 不会得到 Windows 盘符，它在这些平台返回空字符串。输入文本带 C: 并不会切换标准库的路径解释器。

因此，Linux 服务接收 Windows 客户端上报的路径时，先把它归类为“外来路径文本”。可由 Windows 端生成项目内相对路径，或者在服务中采用明确支持 Windows 路径语法的独立处理方案；不要把本例封装声明为跨平台 Windows 路径解析器。

ToSlash 与 FromSlash 的职责是按本机规则替换分隔符，不能建立跨卷相对位置。将反斜杠全部换成斜杠后再调用 path 包，也不会自动获得盘符、UNC 共享与盘符相对路径语义。需要跨机器保存资源标识时，最好在数据格式中分开保存项目标识与项目内相对位置。

在工程中保留错误与路径类型

采用这段封装时，接口文档应明确“输入为本机完整绝对路径，成功输出为相对路径，失败返回错误”。若调用者还需要“跨卷时返回绝对路径”的展示功能，应另设返回类型或明确标记，避免同一个字符串字段有时相对、有时绝对。

为什么不自动调用 Abs？相对路径转绝对路径需要一个可信的解析上下文；直接依赖进程当前目录会把配置语义隐藏起来。调用者有明确基准时再解析，核心封装保持约定清楚。

Rel 成功代表文件存在吗？不代表。它进行词法路径计算，不检查目标是否存在，也不解析符号链接。文件操作和链接处理需要按业务另行设计。

能否把 VolumeName 当成真实磁盘身份？不能。它提取路径文本中的卷名，不查询挂载关系；即使两个路径访问同一存储，它们的不同卷表示也不能因此直接用 Rel 跨越。

Windows 大小写是否必须自己统一？无需为了调用 Rel 先把整条路径转成小写。应保留原始名字，让标准库按平台规则处理；这也不等于验证文件系统中两个名字必定指向同一对象。

相关官方说明：Rel 接口、VolumeName 接口、filepath 官方实现。