filepath.join是唯一安全起点，因它自动适配系统分隔符、跳过空串和"."、合并冗余分隔符、遇绝对路径即截断前序段，但不折叠".."或校验存在性，须配合clean、abs等才能闭环。
必须用 filepath.Join，其他方式在 Windows 上大概率出错——不是“推荐”，是硬性要求。
为什么 filepath.Join 是唯一安全起点
它不只替换 / 和 ，而是整套路径语义处理：自动跳过空字符串和 "."、合并重复分隔符、按系统选择 os.PathSeparator、遇到绝对路径参数立即截断前面所有段。比如 filepath.Join("XML", "/foo.xml") 在 Linux 返回 "/foo.xml"，在 Windows 返回 "C: oo.xml"（取决于当前盘符），而不是拼出 "XML oo.xml" 这种逻辑错误路径。
常见错误现象：os.Open("./XML/" + name) 在 Windows 可能生成 ".XML ile.txt" 或更糟的 ".//XML/file.txt"，部分工具（如某些 CI 环境或静态分析器）会直接拒绝这种格式；fmt.Sprintf("%s/%s", dir, file) 一旦 dir 末尾已有 /，就会变成 path//file，而 filepath.Join 会自动去重。
- 不要传入含分隔符的字符串：❌
filepath.Join(base, "sub/dir/file.txt")→ 应拆成 ✅filepath.Join(base, "sub", "dir", "file.txt") - 首个参数若为绝对路径（如
"C: mp"或"/etc"），前面所有参数被丢弃，这是设计行为，不是 bug -
".."不会被自动折叠：filepath.Join("a", "..", "b")返回"a/../b"，需后续调用filepath.Clean才得"b"
filepath.Join 配合 filepath.Clean 才算闭环
filepath.Join 只做拼接，不解析语义；filepath.Clean 负责归一化："././data/../logs/" → "logs"，"a/b/../../c" → "c"。这对用户输入、环境变量读取的路径尤其关键——否则 filepath.Base("../etc/passwd") 仍返回 "passwd"，掩盖越界风险。
- 必须对不可信输入先
Clean再Join：例如命令行参数--root ./../config，直接Join(root, "app.yaml")会拼出危险路径 -
Clean不检查文件是否存在，也不访问磁盘，纯字符串操作，性能无负担 - 注意边界：
filepath.Clean("/")返回"/"，filepath.Clean("C:")返回"C:."（Windows 下相对路径），不是你想要的盘根
Windows 盘符路径的特殊写法
filepath.Join("C:", "foo") 在 Windows 返回 "C:foo" —— 这是相对路径（相对于 C: 当前工作目录），不是 "C: oo"。要得到后者，必须显式提供根分隔符：
- ✅ 安全写法：
filepath.Join("C:/", "foo", "bar.txt")→"C: ooar.txt"（/在所有平台都兼容，Join自动转） - ✅ 等效写法：
filepath.Join("C:"+string(filepath.Separator), "foo", "bar.txt") - ❌ 危险写法：
filepath.Join("C:", "foo")或filepath.Join("C:\", "foo")（双反斜杠在 Go 字符串中需转义，易漏）
跨平台代码里，永远别假设拼接结果含 /；如果后续逻辑依赖正斜杠（比如 HTTP 响应头、日志路径打印），应单独处理，而非依赖 Join 输出。
什么时候不该用 filepath.Join
拼接 URL、HTTP 路由、POSIX shell 路径字符串时，用 path.Join —— 它强制用 /，不关心操作系统。混用会导致 Windows 下路径失效，比如 path.Join("C:", "foo") 返回 "C:/foo"，但 os.Open 在 Windows 会尝试打开 C:/foo（可能失败），而 filepath.Join 返回的是原生格式。
- 读写本地文件、遍历目录、解析命令行路径 → 用
filepath - 生成 URL、处理 HTTP
PATH_INFO、解析 Unix 风格配置路径 → 用path - 绝不能把
path.Clean结果直接传给os.Stat或os.Open，尤其在 Windows 上
真正容易被忽略的是：即使用了 filepath.Join 和 Clean，也无法防御恶意构造的 "....etcpasswd" —— 它只规范形式，不校验语义。白名单校验、路径前缀限制（如 strings.HasPrefix(cleaned, allowedRoot)）、或最终用 filepath.EvalSymlinks 验证真实位置，才是最后一道防线。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
