filepath.Join 是唯一安全的路径拼接方式，必须传入纯路径组件而非含分隔符字符串，遇绝对路径会截断前面所有参数；filepath.Clean 仅归一化不校验，用户输入需先 Clean 再 Join；敏感操作须用 os.Executable 定位基准点并结合 Abs 与白名单校验。
filepath.Join 是唯一安全的路径拼接方式
硬拼字符串（+ 或 fmt.Sprintf）在 Windows 上大概率导致 no such file or directory，不是兼容性“建议”，是硬性要求。它不感知操作系统语义：比如 "config" + "/" + "app.yaml" 在 Windows 生成 config/app.yaml，部分系统调用能容忍，但 exec.Command 调用 cmd.exe 或 PowerShell 时会直接失败；更糟的是 dir + "/" + "file.txt" 若 dir 末尾已有 /，会变成 path//file.txt，而 filepath.Join 自动去重。
常见错误现象：
-
filepath.Join("app", "/data/file.txt")→/data/file.txt（Linux）或C:\data\file.txt（Windows 当前盘符下），完全丢弃"app" -
filepath.Join("root", "sub", "C:/config.yaml")→C:\config.yaml，前面参数全失效
实操建议：
- 所有本地文件路径拼接，必须用
filepath.Join，不能混用path.Join（后者只认/，Windows 下解析C:\foo\bar.exe返回.） - 传入参数必须是「路径组件」，不是含分隔符的字符串：❌
filepath.Join(base, "sub/dir/file.txt")，✅filepath.Join(base, "sub", "dir", "file.txt") - 首个参数若为绝对路径（如
/etc或C:\tmp），前面所有参数会被丢弃——这是设计行为，不是 bug - 别在循环里高频调用；基础路径（如日志根目录）提前
Join好复用
filepath.Clean 不是“修复器”，而是“归一化器”
filepath.Clean 只做纯字符串变换：压缩重复分隔符、解析 . 和 ..、去掉末尾 /。它不访问磁盘，也不校验路径是否存在或是否越界。
立即学习“go语言免费学习笔记（深入）”；
典型误用：
-
filepath.Clean("../../etc/passwd")→../../etc/passwd，仍可被os.Open静默读取敏感文件 -
filepath.Clean("log/")→log，但filepath.Base("log/")返回空字符串，后续拼扩展名出错
实操建议：
- 对用户输入、配置项、环境变量读取的路径，**必须先
filepath.Clean，再传给filepath.Join** -
filepath.Clean后若以..开头，大概率是越界路径，应拒绝而非放行 - 提取真实文件名前，务必先
filepath.Clean输入路径，再用strings.HasSuffix判断末尾是否为/，否则filepath.Base可能返回空 -
filepath.Clean("/")返回"/"，filepath.Clean("C:")返回"C:."（Windows 下相对路径），不是盘根
敏感操作前必须走 Abs + 白名单校验
filepath.Abs 行为强依赖 os.Getwd()，而工作目录易变且 Windows 各盘符独立，导致路径结构不可比、不可靠。直接用它做白名单校验，在 CI 或容器中极易失败。
正确做法是锚定稳定基准点：
- 用
os.Executable()获取二进制路径，再filepath.Dir()提取所在目录 —— 这是程序“出生地”，不受cd影响 - 再用
filepath.Join(execDir, "config.yaml")构建资源路径，永远不用+或fmt.Sprintf - 对用户输入路径，先
filepath.Clean，再filepath.Abs，最后用strings.HasPrefix(abs, allowRoot+string(filepath.Separator))校验（注意结尾加分隔符防前缀绕过） - 需要物理路径比对（如判断两个 config 是否同一文件），顺序必须是：先
Join→ 再Abs→ 最后filepath.EvalSymlinks；反序可能因相对路径找不到起点而失败
Windows 下 filepath.EvalSymlinks 对 junction 支持有限，某些情况静默失败，别依赖它 100% 成功。
filepath.Base 和 filepath.Dir 的边界行为极易踩坑
这两个函数不“智能”，只按分隔符切分字符串：filepath.Base 是“取最后一个路径段”，filepath.Dir 是“去掉 Base 后剩下的部分”。它们不自动清理输入，也不处理末尾斜杠语义。
典型边界行为：
-
filepath.Base("log/")→""（空字符串），不是"log" -
filepath.Base("/")→"/"，filepath.Base("/home/user/")→"" -
filepath.Dir("singlefile")→"."，不是""；filepath.Dir("/")→"/"
实操建议：
- 提取文件名前，先
filepath.Clean输入路径，再判断是否以/结尾；否则filepath.Base("../etc/passwd")返回"passwd"，掩盖路径穿越风险 - 避免用
filepath.Dir(p)直接参与filepath.Join：比如filepath.Join(filepath.Dir(p), "backup", filepath.Base(p))在p == "file.txt"时变成filepath.Join(".", "backup", "file.txt")，实际是"./backup/file.txt" - 别把
filepath.Dir结果当“父目录绝对路径”用；它只是字符串运算结果，不保证存在或合法
跨平台路径问题最常卡在“以为 Clean 就安全了”或“没意识到 Join 遇到绝对路径就截断”，这两处不细看日志根本看不出错在哪。
