filepath.join是唯一安全跨平台路径拼接方式，但需配合clean归一化、abs转绝对路径并校验范围，因join仅适配分隔符、丢弃空段和截断绝对路径前缀，不清理..或冗余/。
直接用 + 或 fmt.Sprintf 拼路径，在 Windows 上八成会打开失败或读错文件——这不是 bug，是路径语义错乱。唯一安全、跨平台的拼接方式是 filepath.Join，但它不解决所有问题，必须配合 Clean、Abs 等函数按场景组合使用。
为什么 filepath.Join 不能单独扛起所有路径操作
filepath.Join 只做三件事：按平台选分隔符（/ 或 ）、丢弃空字符串和 .、截断前面所有参数遇到绝对路径时（比如传了 "/etc/hosts"）。它不清理冗余 ..、不压缩重复 /、不检查文件是否存在。
-
filepath.Join("a//b", "c")→"a//b/c"（不是"a/b/c"） -
filepath.Join("a", "..", "c")→"a/../c"（不是"c"） - 用户输入
"././config/../data/log.txt"，Join不会动它，后续os.Open可能越界
所以拼完必须跟 filepath.Clean 做归一化；敏感操作（如读配置、写日志）前，还得先转绝对路径再校验范围。
路径越界和符号链接该怎么防
路径穿越漏洞常见于没做 Abs + 范围校验，或误以为 Clean 能“修复”非法路径。而符号链接则容易漏掉 EvalSymlinks 导致两个路径指向同一文件却判为不同。
- 永远先调
filepath.Abs得到规范绝对路径，再用strings.HasPrefix(abs, allowRoot)判断是否在白名单目录内 -
filepath.Clean("../etc/passwd")仍返回"../etc/passwd"，不会报错也不会自动补全，不能当“安全过滤器”用 - 需要真实物理路径比对（比如判断两个 config 是否是同一个文件），必须
Abs后再EvalSymlinks；顺序反了（先EvalSymlinks再Abs）可能因相对路径找不到起点而失败 - Windows 下
EvalSymlinks对 junction 和 hard link 支持有限，某些情况静默失败，别依赖它 100% 成功
filepath.Dir 和 filepath.Base 的边界行为坑最多
这两个函数不“智能”，只按分隔符切分字符串，返回值风格随平台走，但逻辑一致。很多人拿 Base 结果直接拼新路径，结果崩得无声无息。
-
filepath.Base("log/")→""（空字符串），不是"log"；filepath.Base("/") →"/" -
filepath.Dir("singlefile")→"."，不是""；filepath.Dir("/a")→"/" - 提取真实文件名前，务必先
Clean输入路径，再判断末尾是否为/（用strings.HasSuffix），否则Base返回空会导致拼接出错 - 不要用
Dir结果直接参与Join，比如filepath.Join(filepath.Dir(p), "backup", filepath.Base(p))在p == "file.txt"时变成filepath.Join(".", "backup", "file.txt")，实际是"./backup/file.txt"，不是你想要的同级目录
什么时候该用 path 包而不是 filepath
混用 path 和 filepath 是跨平台崩溃高发区。关键看路径用途：面向本地文件系统就锁死 filepath；面向 URL、HTTP 路由、POSIX 风格字符串就用 path。
-
path.Join("api", "v1", "users")→"api/v1/users"，永远是/，适合拼 HTTP endpoint 或生成 URL -
filepath.Join("C:", "foo")→"C:\foo"（Windows），而path.Join("C:", "foo")→"C:/foo"，后者传给os.Open在 Windows 上大概率失败 - 命令行参数里用户输入的是文件路径？全程
filepath - 配置文件里写了
template_root: "/usr/share/templates"？读出来后立刻filepath.Clean+filepath.Abs，别用path.Clean - 没有“通用路径包”，Go 故意拆开，因为语义根本不同：一个管磁盘，一个管线缆
最常被忽略的一点：获取程序自身所在目录，绝不能靠 os.Getwd()，必须用 os.Executable() + filepath.Dir——启动路径不可控，二进制路径才可靠。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
