filepath.clean仅做三件事：合并重复分隔符、消除.、解析..，不转换分隔符、不检查存在性、不校验合法性，是纯字符串语义标准化操作。
filepath.Clean 只压缩路径，不转换分隔符
filepath.Clean 的作用非常具体：它只做三件事——合并重复分隔符、消除 ./、向上回退 ../。它**不会**把反斜杠 换成正斜杠 /，也不会把 / 换成 ，更不会校验路径是否存在或是否合法。
常见错误现象：filepath.Clean("a\b/../c") 在 Windows 上返回 "a/c"（因为 被当成了普通字符），但在 Linux 上传入同样字符串，os.Open 直接报 "no such file or directory"——因为系统根本不认 作分隔符。
- 永远别对用户输入（比如 HTTP path、表单字段）直接调用
filepath.Clean后就去打开文件 - 若来源不可信，先统一分隔符：
strings.ReplaceAll(path, "\", string(filepath.Separator))，再strings.ReplaceAll(..., "/", string(filepath.Separator))，最后filepath.Clean -
filepath.Clean("C:foo bar")不会补盘符后的，结果仍是相对路径"C:foo bar"，不是C: ooar
跨平台拼接必须用 filepath.Join，不能字符串拼接
手动用 + 或 fmt.Sprintf 拼路径，99% 会出错。比如 "dir" + "/" + "file.txt" 在 Windows 上生成 "dir/file.txt"，虽然 os.Open 可能勉强打开，但后续用 filepath.Dir 解析时可能返回空或异常值。
使用场景包括配置目录 + 日志名、模块名转文件路径、URL path 转本地资源路径等。
-
filepath.Join("data", "images", "photo.jpg")在 Windows 返回"dataimagesphoto.jpg"，Linux 返回"data/images/photo.jpg" - 即使某个组件已含分隔符（如
"sub/dir"），Join仍会正确处理，不会多加一层 - 不要在
Join前自己加/或，它会自动适配filepath.Separator
go-git 等成熟项目怎么处理路径规范化
像 go-git 这类跨平台库，在关键路径处理点（如 worktree_status.go）会组合使用 filepath.Clean 和 filepath.ToSlash：
directory = filepath.ToSlash(filepath.Clean(directory))
这一步确保两点：一是路径语义被压缩归一（.//../ 消除），二是所有分隔符强制转为正斜杠，方便后续字符串比较、序列化或日志输出。
-
filepath.ToSlash不影响路径语义，只是把所有替换为/；它不改变filepath.Separator，也不影响os.Open行为 - 如果你要写日志、存数据库、或和前端交换路径字符串，
ToSlash(Clean())是安全选择 - 但注意：转成
/后的路径不能再直接喂给os.Open（Windows 下仍需），除非你确定当前系统支持混合分隔符（大多数现代 Windows API 支持，但非全部）
什么时候该怀疑 Clean 没起作用
当路径看起来“应该能通”却报 "no such file or directory"，尤其发生在不同平台或接收外部输入时，大概率是 Clean 被误用。
- 检查原始字符串是否混用了
/和，且未提前统一 - 检查是否漏了根路径逻辑，比如
filepath.Clean("/a/b/../")返回"/a/"，但filepath.Clean("a/b/../")返回"a/"（相对路径） - 检查盘符处理：Windows 上
"C:foo"和"C:\foo"经Clean后语义完全不同，前者是当前驱动器下相对路径，后者才是 C 盘根目录
最易被忽略的一点：Clean 是纯字符串操作，它不知道你的意图是“打开文件”还是“显示给用户”，所以输入前的预处理和输出后的用途判断，都得你自己兜底。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
