filepath.Join是跨平台路径拼接唯一安全起点，但需配合Clean和Abs才能完整闭环；它遇绝对路径即重置、不自动折叠..、不访问文件系统，且分隔符自动适配系统。
别用 + 或 fmt.Sprintf 拼路径，否则 Windows 上八成会打开错文件或报 no such file or directory；filepath.Join 是唯一安全起点，但它不解决所有问题——得配合 Clean、Abs 才算完整闭环。
filepath.Join 为什么拼出来不是你想要的路径
它遇到任意一个参数是绝对路径（如 "/etc/config.yaml" 或 "C:\tmp"），就会丢弃前面所有参数，直接返回那个绝对路径。这不是 bug，是设计行为。
-
filepath.Join("app", "/data/file.txt")→"/data/file.txt"（Linux/macOS）或"C:data ile.txt"（Windows 当前盘符下） - 传入空字符串或
"."会被忽略，但".."不会自动折叠 ——filepath.Join("a", "..", "b")得到"a/../b"，不是"b" - 它不访问文件系统，纯字符串逻辑，所以性能无负担，但也不能帮你“纠错”
- 跨平台输出分隔符自动适配：
Join("a", "b")在 Linux 输出"a/b"，在 Windows 输出"a"（注意：底层系统调用其实也接受/，但语义和可读性上必须用原生分隔符）
filepath.Base 和 filepath.Dir 的边界行为容易导致空值或误判
Base 不是“取文件名”，而是“取最后一个路径段”；Dir 也不是“取上级目录”，而是“去掉 Base 后剩下的部分”。两者都依赖分隔符切分，且不清理输入。
-
filepath.Base("log/")返回""，不是"log"；filepath.Base("/home/user/")返回""；filepath.Base("/")返回"/" -
filepath.Dir("singlefile")返回"."，不是""；filepath.Dir("a/b/c")返回"a/b"；filepath.Dir("/")返回"/" - 直接对用户输入调用
Base前，务必先filepath.Clean—— 否则filepath.Base("././config.yaml")虽然能返回"config.yaml"，但filepath.Base("../etc/passwd")也会返回"passwd"，掩盖越界风险
什么时候必须用 filepath.Abs + filepath.EvalSymlinks
仅靠 Join 和 Clean 无法确认路径真实指向哪里。要判断两个路径是否等价、防止符号链接逃逸、或做白名单校验，必须走这一步。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
-
filepath.Abs只是把相对路径转成当前工作目录下的绝对路径字符串，不检查存在性，也不解析软链；filepath.EvalSymlinks则要求路径真实存在，并逐级展开所有符号链接 - 顺序不能反：先
Abs，再EvalSymlinks；否则相对路径传给EvalSymlinks会因找不到起点而失败 - Windows 下支持有限：对 junction、hard link 等可能静默失败，别依赖它做关键路径判定
- 敏感操作（如读配置、写日志）前，建议用
strings.HasPrefix(filepath.Clean(abs), allowRoot)做白名单校验，而不是只比对原始输入
filepath.Clean 不是安全过滤器，别把它当防火墙
它只做字符串归一化：压缩重复分隔符、解析 . 和 ..、去掉末尾 /。它完全不访问磁盘，也不拒绝危险路径。
-
filepath.Clean("../../etc/passwd")→"../../etc/passwd"，不会报错，也不会自动截断 -
filepath.Clean("a//b/./c/../d")→"a/b/d"，这是它该干的事 - 若需防御路径遍历，必须结合
Abs后检查是否落在允许根目录内；或者用filepath.Rel(allowRoot, abs)看能否生成合法相对路径 - 它对 Windows 驱动器路径有效：
filepath.Clean("C:\a\..\b")→"C:\b"，但不会把/强制转成
最常被忽略的一点：路径处理链条里，Clean 和 Abs 的调用时机决定了安全性上限。很多人在拼接后才 Clean，却忘了用户输入可能带 ../ 直接穿透；也有人只 Abs 不 EvalSymlinks，结果软链接绕过所有校验。这两步不是可选项，是敏感路径操作的必经关卡。
