本文介绍使用 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:\foo\bar"，将直接返回错误，此时应明确视为 false；
- 始终先调用 filepath.Clean() 消除冗余分隔符和 ./..，避免误判；
- 不要依赖 strings.HasPrefix(child, parent) —— 这在跨平台及含空格、特殊字符路径下极易失效（如 "C:/foo" vs "C:/foobar"）；
- 安全敏感场景（如 Web 服务路径校验），建议额外结合 filepath.EvalSymlinks 检查符号链接真实路径，防止绕过。
综上，filepath.Rel 是 Go 中判断子目录关系最标准、最可靠、真正跨平台的方案。只需几行代码即可实现健壮逻辑，无需引入第三方依赖。
