path.Join用于URL/HTTP路径等纯字符串拼接，filepath.Join才适配操作系统文件系统、自动处理分隔符和相对路径；跨平台文件I/O必须用filepath.Join，且需配合Clean和Abs+白名单校验防路径穿越。
path.Join 和 filepath.Join 容易混用，但语义完全不同
Go 里没有叫 Path 的函数，常见混淆来自 path.Join 和 filepath.Join。前者处理纯字符串路径（如 URL、HTTP 路径），后者才真正适配操作系统文件系统——它会自动替换分隔符（ → / 在 Windows 上，反之亦然），并处理 .. 和 .。
错误示例：path.Join("a", "b/c", "..") 得到 "a/b/c/.."，不会简化；而 filepath.Join("a", "b/c", "..") 在 Linux 下返回 "a"，在 Windows 下也正确归一化。
- 拼接磁盘路径、打开文件、读写目录时，必须用
filepath.Join - 构造 HTTP 路由、API endpoint、URL path segment 时，才考虑
path.Join -
filepath.Join会忽略空字符串和开头的/（如filepath.Join("/a", "b")→"a/b"）
filepath.Clean 不只是去重斜杠，还会解析相对路径
filepath.Clean 是真正的“归一化”操作，不是简单 trim 或 replace。它会递归处理 .. 和 .，合并冗余分隔符，并抹平符号链接语义（注意：不实际访问文件系统）。
典型误用：filepath.Clean("a//b/../c") → "a/c"；filepath.Clean("../../../etc/passwd") → "../../etc/passwd"（因为没根路径，无法向上越界）；但 filepath.Clean("/a/b/../c") → "/a/c"。
立即学习“go语言免费学习笔记（深入）”；
- 若输入含驱动器（Windows），
filepath.Clean("C:\a\..\b")→"C:\b" - 它不检查路径是否存在，也不做权限校验，仅做字符串规整
- 不要依赖它“防御路径穿越”，因为它不拒绝
..—— 需配合白名单或filepath.Abs+ 根目录比对
用 filepath.Abs 处理用户输入前，必须先 Clean 再校验根目录
用户传入 ../../etc/shadow 这类路径时，直接 filepath.Abs 可能生成合法但危险的绝对路径。正确姿势是先 Clean，再确认是否落在允许的根目录下。
root := "/var/www/uploads"
userPath := "../../etc/passwd"
cleaned := filepath.Clean(userPath) // → "../../etc/passwd"
abs, err := filepath.Abs(filepath.Join(root, cleaned)) // → "/etc/passwd"
if !strings.HasPrefix(abs, filepath.Clean(root)+string(filepath.Separator)) {
return errors.New("path escape detected")
}
-
filepath.Abs在 Windows 上可能返回带驱动器的路径（如C: oo），需统一用filepath.VolumeName提取盘符再比对 -
filepath.Join(root, cleaned)必须放在Abs前，否则Abs("../../x")直接从当前工作目录算起，完全失控 - 注意
filepath.Separator是运行时 OS 的分隔符，不能硬写"/"
filepath.FromSlash 和 ToSlash 是跨平台路径字符串转换的唯一安全方式
当你要把 Unix 风格路径（如配置文件中写的 "config/log.txt"）转为当前系统可用路径，或把 Windows 路径存成通用格式时，别用 strings.Replace。它会破坏 UNC 路径（\servershare）或卷标（C:/）。
-
filepath.FromSlash("a/b/c")在 Windows 上返回"a\b\c"，在 Linux 上原样返回"a/b/c" -
filepath.ToSlash("a\b\c")在 Windows 上返回"a/b/c"，适合日志打印、序列化、Web 输出 - 这两个函数只动分隔符，不碰
..、.或内容逻辑，和Clean无替代关系
路径拼接这事，看似只是字符串操作，但跨平台、安全性、运行时行为全藏在细节里。最容易被跳过的其实是 Clean 后的根目录边界检查——它不报错，但放行一次就可能丢权限。
