filepath.Join是唯一安全的跨平台路径拼接方式，它自动适配系统分隔符、清理冗余符号并规范化路径，而硬拼字符串易导致混合分隔符和路径错误。
filepath.Join 是唯一安全的跨平台路径拼接方式
硬拼字符串（比如 dir + "/" + file 或 fmt.Sprintf("%s\%s", dir, file)）在 Windows 上极易生成混合分隔符（如 C: oo/bar.txt），导致 os.Open 偶尔成功但 os.Stat 或第三方库直接失败。错误现象常为 no such file or directory，而文件明明存在。
-
filepath.Join("a", "b", "c")自动用filepath.Separator拼接：Linux 得a/b/c，Windows 得ac - 它同时做规范化：
filepath.Join("a", "..", "b")→b；filepath.Join("a/", "b")→a/b（末尾斜杠被清理） - 绝对路径要显式带根：Windows 下写
filepath.Join("C:\", "foo")或更推荐filepath.Join("C:/", "foo")（/在所有平台都可被Join正确转义） - 禁止把用户输入、环境变量值或命令行参数直接拼进字符串——必须先
filepath.Clean()再Join
filepath.Dir / Base / Ext 解析路径时必须用 filepath 包
path.Dir 会把 当普通字符，解析 "c: ooar.exe" 返回 "."，完全不可用。这是跨平台路径 bug 最隐蔽的来源之一。
- 始终用
filepath.Dir(path)获取目录部分，它按当前 OS 分隔符切分 -
filepath.Base(path)提取文件名（含扩展名），filepath.Ext(path)只取扩展名（含点） - 若路径来自 HTTP 请求或 URL 字符串，先用
path.Clean()，但后续传给os.Open前必须过filepath.FromSlash()转回本地格式 - 不要对
filepath.Join结果做strings.Split(..., "/")——Windows 下整个路径会被当做一个元素
filepath.Clean 和 Abs 处理用户输入和相对路径
用户输入或配置项里的路径常含 ../、./、重复分隔符甚至空段，不清理就直接使用，可能引发路径穿越（如 ../../etc/passwd）或打开错误位置。
- 所有外部来源路径（flag、env、config file、HTTP form）都应先调用
filepath.Clean() -
filepath.Abs("./data")转成绝对路径，但注意：它不处理符号链接，如需真实物理路径，再套filepath.EvalSymlinks() -
filepath.Clean()不改变大小写，Windows 文件系统虽不区分大小写，但路径比较逻辑仍需额外标准化（比如统一转小写） - 测试中避免断言具体分隔符，用
filepath.ToSlash(path)统一转/后再比对字符串
path 和 filepath 绝不能混用的两个典型场景
混用会导致 CI 通过但本地 Windows 报错，或反过来。核心区别是：path 专为 / 设计（URL、ZIP 内部路径），filepath 才对应真实文件系统。
立即学习“go语言免费学习笔记（深入）”；
- 读写本地文件、
os.Stat、os.MkdirAll、遍历目录 → 只能用filepath函数 - 处理 HTTP
Request.URL.Path、生成重定向 Location、解析tar/zip内部路径 → 用path包 - 错误示例：
path.Join("static", "img/logo.png")后直接传给os.Open→ Windows 下变成static/img/logo.png，系统找不到该路径 - 正确做法：
filepath.Join("static", "img", "logo.png")；若需日志输出统一格式，最后用filepath.ToSlash(path)
filepath.Join("D:", "foo") 生成的是相对路径（相对于 D: 盘当前工作目录），不是你想要的 D: oo。这个细节在构建安装器或日志根目录时，几乎每次都会踩一次。 
