Go 的 filepath 包专为操作系统感知的路径语义设计，strings 操作无法适配不同系统的分隔符、无法处理 .. 和 .、不能标准化路径，易导致跨平台错误或安全漏洞。
Go 的 filepath 包不是“路径字符串处理器”，而是专为**操作系统感知的路径语义**设计的工具集；直接用 strings.Split() 或 strings.Replace() 操作路径，大概率在 Windows 上出错或跨平台行为不一致。
为什么不能用 strings 处理路径
Windows 用反斜杠 \，Linux/macOS 用正斜杠 /，而 Go 的 filepath 会自动适配：filepath.Join("a", "b") 在 Windows 返回 "a\b"，在 Linux 返回 "a/b"。硬编码分隔符或手动拼接，会破坏这种一致性。
- 错误示例：
"dir" + "/" + "file.txt"→ 在 Windows 可能被系统接受但语义模糊，filepath.IsAbs()判定失败 -
filepath.Clean()会标准化冗余分隔符和..，strings完全无法模拟该逻辑 - 某些函数（如
filepath.WalkDir）依赖底层 OS 的路径解析规则，绕过filepath就等于放弃安全边界
filepath.Join 和 filepath.Clean 的典型组合用法
构建路径时，先用 Join 拼接各段，再用 Clean 去除冗余并标准化格式。尤其在用户输入或配置拼接场景中，这步不可省略。
path := filepath.Join("logs", "..", "config", "app.json")
cleaned := filepath.Clean(path) // → "config/app.json"（Linux）或 "config\app.json"（Windows）
-
Join不做任何清理，只负责拼接和分隔符适配 -
Clean会处理..、.、重复分隔符（如//）、首尾空格等 - 若拼接后需判断是否为绝对路径，必须对
Clean后的结果调用filepath.IsAbs()
区分 filepath.Base 和 filepath.Dir 的边界行为
Base 返回最后一个路径元素（不含分隔符），Dir 返回其上级目录；但它们对根路径、空字符串、纯分隔符等有明确定义，容易误判。
立即学习“go语言免费学习笔记（深入）”；
fmt.Println(filepath.Base("/")) // "/"
fmt.Println(filepath.Base("")) // "."
fmt.Println(filepath.Dir("/a/b/")) // "/a"
fmt.Println(filepath.Dir("a")) // "."
-
Base("")返回"."，不是空字符串；若用于文件名校验，需额外判断 -
Dir("/a/b/")去掉末尾斜杠后才取上一级，所以结果是"/a"；但Dir("/a/b")也是"/a" - 不要用
Base提取扩展名——它不拆分.，应配合filepath.Ext()使用
用 filepath.WalkDir 避免递归陷阱
WalkDir 是推荐的替代 Walk 的新函数（Go 1.16+），它使用 fs.DirEntry，避免了提前读取全部子项的开销，且能跳过子树。
err := filepath.WalkDir("/data", func(path string, d fs.DirEntry, err error) error {
if err != nil {
return err
}
if d.IsDir() && d.Name() == "temp" {
return filepath.SkipDir // 跳过整个 temp 目录
}
if !d.IsDir() && strings.HasSuffix(d.Name(), ".log") {
fmt.Println("found:", path)
}
return nil
})
-
回调函数中的
path是绝对路径（若传入的是绝对路径），无需再Join -
filepath.SkipDir是唯一合法的跳过方式；返回nil或其他 error 都会中断遍历 - 注意：如果传入相对路径（如
"./src"），path也是相对的，IsAbs(path)为 false
最常被忽略的是 Clean 的必要性——哪怕你只在 Linux 下开发，只要路径来自用户输入、HTTP 参数或配置文件，就必须 Clean；否则 ../etc/passwd 这类路径可能绕过你的校验逻辑。
