filepath.join是唯一安全起点，因它自动适配系统分隔符、跳过空串和"."、合并冗余分隔符、遇绝对路径即截断前序段，但不折叠".."或校验存在性，须配合clean、abs等才能闭环。
filepath.Join 是唯一安全的起点，其他拼接方式在 Windows 上大概率触发 no such file or directory 错误。
为什么必须用 filepath.Join 而不是字符串拼接
硬编码 /、用 + 或 fmt.Sprintf 拼路径，在 Windows 下会产出混合分隔符（如 dirsub/file.txt）或非法路径（如 .//config.yaml），部分工具链（CI、静态分析器）直接拒绝解析。
-
filepath.Join("XML", "file.txt")在 Linux 输出XML/file.txt，在 Windows 输出XML ile.txt，且自动跳过空串和"." -
filepath.Join("a/", "b")→a/b（合并冗余分隔符），而"a/" + "b"→a/b（Linux 正常，Windows 可能被解释为相对路径错误） - 传入含分隔符的子路径是常见错误：
❌ filepath.Join(base, "sub/dir/file.txt")→ 应拆成✅ filepath.Join(base, "sub", "dir", "file.txt")
filepath.Join 不做语义解析，filepath.Clean 才负责归一化
Join 只连接，不折叠 ".."、不压缩重复 /、不校验存在性。比如 filepath.Join("a", "..", "b") 返回 a/../b，不是 b；filepath.Join("a//b", "c") 返回 a//b/c，不是 a/b/c。
- 用户输入、环境变量读取的路径必须先
filepath.Clean再Join，否则filepath.Base("../etc/passwd")仍返回"passwd"，掩盖越界风险 -
filepath.Clean是纯字符串操作，不访问磁盘，性能无负担；但filepath.Clean("/")返回"/"，filepath.Clean("C:")返回"C:."（Windows 下相对路径，非盘根） - 敏感操作（如
os.Open）前，不能只靠Clean—— 它不阻止../../etc/passwd这类越界路径
绝对路径参数会截断前序段，这是设计行为不是 bug
filepath.Join("data", "/etc/config.yaml") 在 Linux 返回 /etc/config.yaml，在 Windows 可能返回 C:etcconfig.yaml（取决于当前盘符），前面的 "data" 被完全丢弃。
- 同理，
filepath.Join("C:\tmp", "foo.txt")→C: mp oo.txt；但filepath.Join("C:", "foo.txt")→C:foo.txt（这是相对于 C: 当前工作目录的相对路径，不是C: oo.txt） - 要得到盘根路径，需显式提供分隔符：
filepath.Join("C:"+string(os.PathSeparator), "foo.txt") - 这个行为常被误认为 bug，实则是路径语义的一部分：遇到任意绝对路径参数即重置上下文
别用 path.Dir 处理本地文件路径，一律换 filepath.Dir
path.Dir 永远只认 /，在 Windows 上处理 "C:Usersme ile.txt" 时，因无 /，返回 "."，而非预期的 "C:Usersme"。
-
filepath.Dir自动感知系统分隔符：filepath.Dir("C:\Users\me\file.txt")→"C:\Users\me"（Windows），filepath.Dir("/usr/local/bin/app")→"/usr/local/bin"（Linux） -
filepath.Base("log/")返回空字符串""，不是"log"；提取真实文件名前应先filepath.Clean，再判断末尾是否为/ - 对不可信输入，
filepath.Dir的输出仍可能是相对路径（如".."），需配合filepath.Abs和白名单校验
filepath.Join 和 filepath.Clean 是基础，但真正防越界要靠 filepath.Abs + 白名单比对；filepath.EvalSymlinks 虽可解符号链接，但它要求路径真实存在，且 Windows 对 junction 支持有限——这些细节在配置加载、用户上传路径等场景里，最容易被跳过。
