filepath.Join是跨平台路径拼接的唯一安全入口，必须用于所有本地文件系统路径拼接；它忽略""和"."、不解析".."、丢弃前面参数遇绝对路径，且不可用path.Join替代。
硬编码 / 或 \ 拼路径，在 Windows 上大概率触发 no such file or directory；唯一安全起点是 filepath.Join，但它不解决越界、符号链接或用户输入校验——这些得靠后续组合动作。
filepath.Join 是跨平台路径拼接的唯一安全入口
它不是“推荐用”，而是“必须用”。所有本地文件系统路径拼接，都该从 filepath.Join 开始。
-
filepath.Join("config", "env.yaml")在 Linux 输出config/env.yaml，在 Windows 输出config\env.yaml（注意：底层系统调用虽兼容/，但语义和可读性要求原生分隔符） - 传入任意参数为绝对路径（如
"C:\tmp"或"/etc/passwd"），前面所有参数会被丢弃——这是设计行为，不是 bug -
""和"."被忽略，".."不解析，纯字符串逻辑，无副作用也无文件系统访问 - 别用
path.Join替代——它是为 URL 设计的，不处理盘符、不识别 Windows 路径语义
filepath.Clean 不能代替权限校验，只做字符串归一化
filepath.Clean 很快、很轻量，但完全不检查路径是否存在，也不展开符号链接。它只是把 a//b/../c 变成 a/c，把 ./foo 变成 foo。
- 用户输入
"../../etc/passwd"，Clean后仍是../../etc/passwd，os.Open可能静默读取敏感文件 - 对用户输入或外部传入路径，必须先
Clean，再Abs，最后比对白名单前缀（如strings.HasPrefix(abs, "/var/app/")） - 若需防符号链接绕过（比如
../link-to-root指向/），再追加filepath.EvalSymlinks，但注意它要求路径真实存在，且 Windows 对 junction 支持有限
filepath.Dir 和 filepath.Base 的边界行为容易踩坑
这两个函数按分隔符切分后取段，不判断是否为目录，也不做存在性检查。
Golang Google Wire
下载
在 Go 中使用 google/wire 实现编译时依赖注入——wire.NewSet、wire.Build、wire.Bind（接口→实现）、wire.Struct、wire.Value、wire.Interface
立即学习“go语言免费学习笔记（深入）”；
-
filepath.Base("log/")返回""，不是"log"；filepath.Base("/home/")返回""，而filepath.Base("/home")返回"home" -
filepath.Dir("singlefile")返回"."，不是空字符串；filepath.Dir("/a/b/c")返回/a/b，但filepath.Dir("/")返回"/" - 提取真实文件名前，先
filepath.Clean输入路径，再用strings.HasSuffix(path, string(filepath.Separator))判断是否为目录结尾
避免在循环里反复调用 Join+Clean+Abs
基础路径结构（如日志根目录、配置模板根路径）通常是静态的，提前算好复用更高效，也减少出错点。
- 错误写法：
for _, f := range files { p := filepath.Join(base, f); abs, _ := filepath.Abs(filepath.Clean(p)); ... } - 正确做法：提前计算
baseAbs, _ := filepath.Abs(filepath.Clean(base))，循环内只用filepath.Join(baseAbs, f) -
filepath.Abs可能失败（如当前工作目录被删除），敏感场景应显式处理 error，而非用_忽略
真正麻烦的从来不是拼路径，而是用户输入 + 相对路径 + 符号链接 + 权限白名单这四者叠加时的逃逸风险。每一步都看似简单，但漏掉 Abs 或跳过前缀校验，就可能让 filepath.Join 的安全性归零。
