必须用 filepath.Join 拼接本地文件路径，因其自动处理系统分隔符、去重冗余斜杠、支持绝对路径重置语义；其他方式如 + 或 fmt.Sprintf 易导致跨平台路径错误或安全漏洞。
必须用 filepath.Join 拼接本地文件路径，其他方式在 Windows 上大概率导致 no such file or directory 或静默读错文件——这不是兼容性“建议”，是硬性要求。
为什么不能用 + 或 fmt.Sprintf 拼路径
字符串拼接不感知操作系统语义："config" + "/" + "app.yaml" 在 Windows 上生成 config/app.yaml，虽部分系统调用能容忍，但遇到 exec.Command 调用 PowerShell、cmd.exe 或某些 CI 工具时会直接失败；更糟的是 dir + "/" + "file.txt" 若 dir 末尾已有 /，会变成 path//file.txt，而 filepath.Join 会自动去重。
-
filepath.Join("a//b", "c")→"a//b/c"（需后续filepath.Clean归一化） -
filepath.Join("a", "..", "b")→"a/../b"（不是"b"，Clean才折叠） - 传入含分隔符的字符串（如
"sub/dir/file.txt"）是错的，应拆成Join(base, "sub", "dir", "file.txt")
filepath.Join 遇到绝对路径就“重置”，这是设计行为
它不是 bug，是明确的语义：只要任意参数是绝对路径（如 "/etc/hosts" 或 "C:\tmp"），前面所有参数都会被丢弃。比如 filepath.Join("app", "/data/file.txt") 在 Linux 返回 "/data/file.txt"，在 Windows 可能返回 "C:data ile.txt"（取决于当前盘符）。
- 空字符串和
"."会被忽略，但".."不会自动解析 -
filepath.Join("C:", "foo")在 Windows 返回"C:foo"—— 这是相对路径（相对于 C: 当前目录），不是"C:\foo"；要得到后者，得写filepath.Join("C:\", "foo") - 别在循环里高频调用；基础路径（如日志根目录）提前
Join好复用
用户输入路径必须走 Abs + Clean + 白名单校验
filepath.Clean 只做字符串归一化，不检查存在性，也不转绝对路径：filepath.Clean("../etc/passwd") 仍返回 "../etc/passwd"。直接 os.Open 它，可能越界读取敏感文件。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 先
abs, err := filepath.Abs(input)，再cleaned := filepath.Clean(abs) - 白名单校验用
strings.HasPrefix(cleaned, allowRoot+string(filepath.Separator))，注意结尾加分隔符防前缀匹配绕过（如allowRoot="/opt/myapp"，不加Separator可能误放行/opt/myapp_hacked） -
filepath.Base("log/")返回空字符串，filepath.Dir("singlefile")返回"."—— 提取文件名或父目录前，务必先Clean输入，再判断是否以/结尾
符号链接和物理路径判定必须用 EvalSymlinks，但顺序和平台限制极多
仅靠 Abs + Clean 无法确认两个路径是否指向同一文件，因为符号链接会让逻辑路径和物理路径分离。必须用 filepath.EvalSymlinks，但它有硬性前提：
- 顺序不能反：必须先
Abs，再EvalSymlinks；否则相对路径传给EvalSymlinks会因找不到起点而失败 -
EvalSymlinks要求路径真实存在，不存在则返回 error；Windows 下对 junction、hard link 支持有限，某些情况静默失败 - 容器或 CI 环境中
Abs返回的路径（如/workspace/...）和宿主机路径无法直接比对，别依赖字符串相等
最易被忽略的一点：程序自身资源路径不能靠 os.Getwd()，它返回进程启动目录，不是二进制所在位置；正确做法是 os.Executable() + filepath.Dir，但要注意 UPX 压缩、CGO、快捷方式启动等场景下可能失效，必须加 fallback 和错误处理。
