filepath.Clean 仅压缩 ./、../ 和重复分隔符，不统一分隔符、不校验合法性、不处理盘符边界；跨平台路径需先统一为系统分隔符再 Clean，拼接必须用 filepath.Join，防遍历须 Clean 后加根路径校验。
filepath.Clean 不是“标准化路径”的终点，它只是第一步。它不转换分隔符、不校验合法性、不处理盘符边界，直接拿它拼接或打开文件，90% 的跨平台路径失败都源于此。
filepath.Clean 只做三件事：压缩 ./、../ 和重复分隔符
它的行为严格遵循路径字符串的文本规整逻辑，和操作系统无关：
-
filepath.Clean("a/b/../c")→"a/c"（正确） -
filepath.Clean("a//b/./c")→"a/b/c"（正确） -
filepath.Clean("C:fooar")→"C:foo\bar"（Windows 下保留反斜杠，但没加盘符后分隔符，仍是相对路径） -
filepath.Clean("a /c")→"a /c"（空格+正斜杠混用？Clean 完全不管——这不是非法字符，它只认.、..、分隔符重复）
所以别指望它把用户输入的 "datalogspp.log" 自动转成 Linux 可读的 "data/logs/app.log"；它在 Linux 上原样返回，os.Open 会直接报 "no such file or directory"。
用户输入路径必须先统一分隔符再 Clean
来自 HTTP 请求、表单、CLI 参数的路径，可能含任意分隔符组合（/、、甚至 \ 或混合），不能直接喂给 filepath.Clean：
立即学习“go语言免费学习笔记（深入）”；
- 先用
strings.ReplaceAll(userPath, "\", string(filepath.Separator))把所有反斜杠替换成当前系统分隔符 - 再用
strings.ReplaceAll(..., "/", string(filepath.Separator))把正斜杠也统一过去（避免遗漏） - 最后调用
filepath.Clean压缩./、../等
示例：
userPath := "logs\../config/app.json" cleaned := filepath.Clean(strings.ReplaceAll(strings.ReplaceAll(userPath, "\", string(filepath.Separator)), "/", string(filepath.Separator))) // → "config/app.json"（Linux 下为 "config/app.json"，Windows 下为 "configpp.json"）
拼接路径永远用 filepath.Join，别用字符串 +
手动拼接几乎必然出错：
-
"dir" + "/" + "file.txt"在 Windows 上生成"dir/file.txt"，os.Open虽能开，但filepath.Dir可能返回空或异常值 -
fmt.Sprintf("%s/%s", dir, file)在 Windows 上会产出错误分隔符，且无法处理dir末尾是否带分隔符 -
filepath.Join自动合并多余分隔符、解析..、适配系统分隔符，还支持任意数量参数
注意：filepath.Join("a", "/b") 在 Unix 下结果是 "/b"（丢弃前面所有），因为它按本地文件系统语义模拟 cd 行为——这不是 bug，是设计使然。绝对路径段会截断前面内容。
防目录遍历必须 Clean + 根路径前缀校验
filepath.Clean 是防越界的第一步，但不是全部：
- 先 Clean 用户输入，得到规整路径（如
"../../../etc/passwd"→"/etc/passwd"） - 再与根目录拼接：
absPath := filepath.Join(root, cleaned) - 校验是否仍在根内：
!strings.HasPrefix(absPath, filepath.Clean(root)+string(filepath.Separator)) - 更健壮的做法是用
filepath.Rel(root, absPath)，若返回错误或结果以".."开头，说明已逃逸
漏掉 Clean 直接拼接，或只比对未 Clean 的 root，Windows 下因盘符和分隔符差异极易绕过校验。
真正麻烦的从来不是 filepath.Clean 本身，而是它不做却常被误以为做了的事：统一分隔符、校验合法性、保证在根内。每一步都得手动补全，少一步就可能在另一台机器上静默失败。
