判断 Go 路径父子关系的跨平台方法

本文介绍如何在 Go 中跨平台判断一个路径是否为另一个路径的子目录，核心方法是使用 `filepath.Rel` 函数解析相对路径，并通过检查返回结果是否以 `..` 开头或是否为绝对路径来准确判定包含关系。

在 Go 语言中，判断路径 A 是否为路径 B 的子目录（subdirectory），即 A 是否完全位于 B 下（如 c:\foo\bar\baz 是 c:\foo\bar 的子目录），需兼顾跨平台兼容性（Windows 路径分隔符 \ vs Unix /）和语义正确性（避免符号链接、大小写、挂载点等干扰）。Go 标准库 path/filepath 提供了可靠的工具，其中 filepath.Rel 是最简洁且健壮的切入点。

✅ 推荐方案：filepath.Rel + 有效性校验

filepath.Rel(base, target) 返回从 base 到 target 的相对路径。若 target 是 base 的合法子路径（即 target 在 base 目录树内且无向上跳转），则返回值：

• 不为空字符串；
• 不以 ".." 开头（表示未跳出 base）；
• 不包含 "/" 或 \ 开头的绝对路径片段（即非绝对路径）；
• 同时，base 和 target 必须是同一卷/根路径下的规范路径（filepath.Clean 可预处理）。

示例代码如下：

package main

import (
    "fmt"
    "path/filepath"
)

// IsSubdir returns true if child is a subdirectory of parent.
// Both paths are cleaned and resolved relatively (case-insensitive on Windows).
func IsSubdir(parent, child string) bool {
    parent = filepath.Clean(parent)
    child = filepath.Clean(child)

    rel, err := filepath.Rel(parent, child)
    if err != nil {
        return false // e.g., different drives on Windows, or invalid path
    }

    // rel == "." means child == parent → not a *sub*directory (strictly speaking)
    // rel == "" is impossible after Clean + Rel, but safe to exclude
    if rel == "." || rel == "" {
        return false
    }

    // Check: no ".." prefix and not absolute
    return !filepath.IsAbs(rel) && !strings.HasPrefix(rel, ".."+string(filepath.Separator)) && !strings.HasPrefix(rel, "..")
}

// Note: import "strings" needed for strings.HasPrefix above

⚠️ 重要注意事项：

• filepath.Rel 不解析符号链接，仅做字面路径比较。如需真实文件系统语义（如跟随 symlink），需结合 os.Stat 和 os.Readlink 手动处理。
• Windows 下注意盘符大小写：C:\foo 和 c:\foo 视为相同路径（filepath.Clean 会标准化），但跨盘符（如 C: vs D:）调用 Rel 会直接返回错误。
• IsSubdir("c:/foo", "c:/FOO/BAR") 在 Windows 上返回 true（默认不区分大小写），但在 Linux 上可能为 false —— 若需严格一致，建议统一转为小写（仅限 Windows）或依赖 os.Stat 获取真实路径。
• 空路径、.、.. 等边界情况务必用 filepath.Clean 预处理，避免误判。

✅ 更严谨的替代方案（推荐生产环境）

若需 100% 文件系统级准确（如处理挂载点、硬链接、大小写敏感等），应结合 os.Stat 获取真实路径的 os.FileInfo 并比对 os.PathError，但代价是 I/O 开销。对于绝大多数配置解析、路径白名单等场景，Rel 方案已足够安全高效。

总结：filepath.Rel 是 Go 中判断路径包含关系的跨平台首选；配合 filepath.Clean 和简单前缀校验，即可准确、轻量、可靠地实现子目录判定。