filepath.join是跨平台路径拼接唯一安全起点，但遇绝对路径即重置、不自动折叠..、不解析符号链接，须配合clean、abs、evalsymlinks才能完整闭环并防遍历。
别用 + 或 fmt.Sprintf 拼路径，90% 的跨平台文件打开失败、路径穿越、Windows 上报 no such file or directory 都源于此；filepath.Join 是唯一安全起点，但它不自动折叠 ..、不校验越界、不解析符号链接——这些得靠 filepath.Clean、filepath.Abs 和 filepath.EvalSymlinks 补齐。
filepath.Join 为什么拼出来不是你想要的路径
它遇到任意一个参数是绝对路径（比如 "/etc/config.yaml" 或 "C:\tmp"），就会丢弃前面所有参数，直接返回那个绝对路径。这不是 bug，是按 shell 路径语义设计的：相当于先 cd a/b 再 cd /c/d，最终就在 /c/d。
-
filepath.Join("app", "/data/file.txt")→"/data/file.txt"（Linux/macOS）或"C:\data\file.txt"（Windows 当前盘符下） - 传入空字符串或
"."会被忽略，但".."不会自动折叠：filepath.Join("a", "..", "b")得到"a/../b"，不是"b" - 它不访问文件系统，纯字符串逻辑，所以快，但也意味着不会帮你“纠错”——比如
"../passwd"会被原样拼进去
filepath.Base 和 filepath.Dir 的边界行为容易导致空值或误判
filepath.Base 不是“取文件名”，而是“取最后一个路径段”；filepath.Dir 也不是“取上级目录”，而是“去掉 Base 后剩下的部分”。两者都依赖分隔符切分，且不做任何清理。
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
-
filepath.Base("log/")返回""，不是"log"；filepath.Base("/")返回"/" -
filepath.Dir("singlefile")返回"."，不是""；filepath.Dir("/")返回"/" - 直接对用户输入调用
Base前，务必先filepath.Clean——否则filepath.Base("../etc/passwd")也会返回"passwd"，掩盖越界风险
什么时候必须用 filepath.Abs + filepath.EvalSymlinks
仅靠 Join 和 Clean 无法确认路径真实指向哪里。要判断两个路径是否等价、防止符号链接逃逸、或做白名单校验，必须走这一步。
-
filepath.Abs只是把相对路径转成当前工作目录下的绝对路径字符串，不检查存在性，也不解析软链 -
filepath.EvalSymlinks则要求路径真实存在，并逐级展开所有符号链接；若路径不存在，它直接返回 error - 顺序不能反：先
Abs，再EvalSymlinks；否则相对路径传给EvalSymlinks会因找不到起点而失败 - Windows 上对 junction/hard link 支持有限，
EvalSymlinks可能静默失败，不能完全依赖
如何防目录遍历：Clean 是第一步，但还不够
用户输入的路径片段（如 API 参数、配置项）必须先 filepath.Clean，再和根目录拼接，最后验证是否仍在根内——否则 "../../../etc/passwd" 会直接穿透。
-
cleaned := filepath.Clean(userPath)→ 把"../../etc/passwd"变成"/etc/passwd" -
absPath := filepath.Join(root, cleaned)，但不能直接用strings.HasPrefix(absPath, root)—— Windows 盘符大小写、尾部分隔符都会破坏匹配 - 正确做法是：
if !strings.HasPrefix(absPath, filepath.Clean(root)+string(filepath.Separator))，或更健壮地用_, err := filepath.Rel(root, absPath)；如果err != nil或返回路径以".."开头，说明已逃逸
最常被忽略的是：即使用了 filepath.Join，只要没加 Clean 和范围校验，用户仍可通过 ../ 突破限制；而 Abs 的输出又依赖当前工作目录，测试中 os.Chdir 一调就崩——这些细节不显眼，但线上出问题时最难排查。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
