本文介绍使用 go 标准库 `filepath.rel` 函数，以简洁、安全、跨平台的方式判断一个路径是否为另一路径的子目录（含 windows 和 unix 系统），并提供可直接运行的示例代码与关键注意事项。
在 go 开发中，经常需要判断两个文件路径之间的包含关系，例如验证用户输入的路径是否落在允许的操作根目录内（防止路径遍历攻击），或检查配置项是否位于项目工作区之下。由于不同操作系统使用不同的路径分隔符（windows 用 ，unix/linux/macOS 用 /），手动字符串匹配极易出错且不具备可移植性。
Go 标准库 path/filepath 提供了真正跨平台的路径处理能力，其中 filepath.Rel(basepath, targpath) 是解决该问题的核心工具：
- 它返回从 basepath 到 targpath 的相对路径；
- 若 targpath 是 basepath 的子路径（即 basepath 是 targpath 的祖先目录），则 Rel 返回一个不包含 “..” 段的纯相对路径（如 “baz” 或 “sub/dir”）；
- 若 targpath 不在 basepath 下（如位于其上级或完全无关路径），Rel 要么返回含 “..” 的路径（如 “../other”），要么返回错误（如路径格式不兼容或越界）。
因此，判断逻辑可归纳为：
✅ targpath 是 basepath 的子目录 ⇔ filepath.Rel(basepath, targpath) 成功返回，且结果不以 “..” 开头，且不等于 “.”（”.” 表示两路径完全相同，严格来说不是“子目录”，而是自身）。
以下是一个健壮、生产可用的封装函数：
package main import ( "fmt" "path/filepath" ) // IsSubdir returns true if child is a subdirectory of parent. // Both paths are cleaned and made absolute before comparison. // It handles cross-platform path separators automatically. func IsSubdir(parent, child string) (bool, error) { // Clean both paths to resolve "." and ".." and normalize separators parentClean := filepath.Clean(parent) childClean := filepath.Clean(child) // Compute relative path from parent to child rel, err := filepath.Rel(parentClean, childClean) if err != nil { return false, err // e.g., mismatched volumes on windows } // Not a subdirectory if rel starts with ".." or is "." if rel == "." || filepath.IsAbs(rel) || filepath.HasPrefix(rel, ".."+string(filepath.Separator)) || rel == ".." { return false, nil } // Also exclude cases where rel contains ".." anywhere (e.g., "../foo/bar") if filepath.ToSlash(rel) == "." || filepath.ToSlash(rel) == ".." || filepath.ToSlash(rel)[:3] == "../" { return false, nil } // Simpler & safer: check that no path component is ".." for _, elem := range strings.Split(filepath.ToSlash(rel), "/") { if elem == ".." { return false, nil } } return true, nil } // 更推荐的简化版（Go 1.20+ 可用，更清晰） func IsSubdirSimple(parent, child string) bool { parentClean := filepath.Clean(parent) childClean := filepath.Clean(child) rel, err := filepath.Rel(parentClean, childClean) if err != nil { return false } if rel == "." { return false // same directory, not subdir } return !strings.HasPrefix(filepath.ToSlash(rel), "../") && !filepath.IsAbs(rel) }⚠️ 重要注意事项：
- filepath.Rel 在 Windows 上会校验盘符（volume）是否一致；若 parent=”C:foo” 而 child=”D:foobar”，将直接返回错误，此时应明确视为 false；
- 始终先调用 filepath.Clean() 消除冗余分隔符和 ./..，避免误判；
- 不要依赖 strings.HasPrefix(child, parent) —— 这在跨平台及含空格、特殊字符路径下极易失效（如 “C:/foo” vs “C:/foobar”）；
- 安全敏感场景（如 Web 服务路径校验），建议额外结合 filepath.EvalSymlinks 检查符号链接真实路径，防止绕过。
综上，filepath.Rel 是 Go 中判断子目录关系最标准、最可靠、真正跨平台的方案。只需几行代码即可实现健壮逻辑，无需引入第三方依赖。