filepath.join 是跨平台路径拼接的唯一安全方式，它自动适配系统分隔符、清理冗余符号，但遇绝对路径会丢弃前置参数；用户输入须先 clean 再 join，且 http 路径与本地路径不可混用。
filepath.Join 是跨平台路径拼接的唯一安全方式
硬拼字符串（比如 dir + "/" + file 或 fmt.Sprintf("%s\%s", dir, file)）在 Windows 上几乎必然导致混合分隔符，例如 C: oo/bar.txt，进而触发 no such file or directory 错误——即使文件真实存在。这不是运气问题，而是路径语义被破坏。
filepath.Join 自动使用 filepath.Separator（Linux/macOS 为 /，Windows 为 ）拼接，并清理冗余符号：
-
filepath.Join("a", "b", "c")→a/b/c（Linux）或ac（Windows） -
filepath.Join("a/", "b")→a/b（末尾斜杠被移除） -
filepath.Join("a", "..", "b")→a/../b（不自动折叠，需后续Clean）
注意：它遇到任意参数是绝对路径（如 "C: mp" 或 "/etc"），会直接丢弃前面所有参数——这是设计行为，不是 bug。
用户输入或环境变量路径必须先 Clean 再 Join
用户提交的路径、配置文件读取的值、命令行参数，常含 ../、./、重复分隔符甚至空段。不清理就直接用 Join 或 os.Open，可能造成路径穿越或打开错误位置。
filepath.Clean 只做字符串归一化：压缩 //、解析 . 和 ..、去掉末尾 /。但它不检查文件是否存在，也不展开符号链接：
-
filepath.Clean("../../etc/passwd")→../../etc/passwd（原样返回，不阻止越界） -
filepath.Clean("a//b/./c/")→a/b/c - 敏感操作前，应结合
filepath.Abs获取绝对路径，再用strings.HasPrefix校验是否落在白名单目录内
别把 Clean 当“修复器”——它不解决越权问题，只解决格式混乱。
path.Dir 和 filepath.Dir 完全不能混用
path.Dir 始终按 / 切分，对 Windows 路径无效：path.Dir(`c: ooar.exe`) 返回 .，而非 c: oo。这是跨平台 bug 最隐蔽的来源之一。
所有本地文件系统操作（os.Open、os.Stat、命令行参数解析）必须用 filepath 包：
-
filepath.Dir("c:\foo\bar.exe")→c: oo（Windows） -
filepath.Base("log/")→""（不是"log"），因为末尾/被视为目录标识 -
filepath.Ext("archive.tar.gz")→".gz"（只取最后一个点后的部分）
提取文件名前，务必先 filepath.Clean 输入路径，再判断是否以 / 或 结尾（用 strings.HasSuffix），否则 Base 可能返回空字符串。
HTTP 路径和本地路径必须严格区分包
path 包专为 URL、URI、POSIX 风格路径设计；filepath 包专为本地文件系统设计。混用会导致 Windows 下路径失效或测试不一致：
- 用
path.Join("static", "css", "main.css")拼出static/css/main.css→ 可用于 HTTP 路由或生成 URL - 但若把这个结果直接传给
os.Open，Windows 下会尝试打开static/css/main.css（找不到），而不是staticcssmain.css - HTTP 请求中的路径（如
r.URL.Path）要用path.Clean，但传给os.Open前必须过filepath.FromSlash转回本地格式
一个常见坑：在 Web 框架中用 path.Join 拼静态资源路径后直接 ioutil.ReadFile，开发时 Linux 正常，上线 Windows 环境就报错——根本原因就是包选错了。
真正麻烦的不是分隔符本身，而是路径语义在不同上下文（URL vs 文件系统、用户输入 vs 硬编码）中如何保持一致。哪怕 os.Open 底层接受 /，你也该用 filepath.Join 输出原生分隔符——因为第三方库、日志输出、调试打印都依赖这个语义。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
