不能用 + 或 fmt.Sprintf 拼路径，因不感知系统分隔符、不压缩冗余斜杠、无绝对路径截断逻辑；必须用 filepath.Join 拼接 + filepath.Clean 规范 + filepath.Abs/Executable 定基准 + 白名单校验防越界。
为什么不能用 + 或 fmt.Sprintf 拼路径
直接写 "config/" + filename 或 dir + "/log.txt" 在 Windows 上大概率导致 no such file or directory 错误，或静默读错文件——这不是“偶尔不兼容”，而是路径语义从源头就错了。
- 字符串拼接不感知系统分隔符：
"data\logs" + "/" + "app.log"在 Windows 生成data\logs/app.log，部分 Go 标准库调用能容忍，但exec.Command("cmd.exe", "/c", "type", path)会直接失败 - 冗余斜杠无法自动压缩：
"a//b" + "/" + "c"得到a//b/c，而filepath.Join("a//b", "c")返回a/b/c（Linux）或a\b\c（Windows） - 绝对路径截断逻辑缺失：
"root" + "/etc/passwd"拼出root/etc/passwd，但filepath.Join("root", "/etc/passwd")正确丢弃"root"，返回/etc/passwd
filepath.Join 必须配合 filepath.Clean 使用
filepath.Join 只负责安全拼接，不归一化路径结构。它保留 ".."、不压缩重复 /、也不处理末尾斜杠，这些必须由 filepath.Clean 补足。
-
filepath.Join("a//b", "c")→"a//b/c"（不是"a/b/c"），filepath.Clean后才变成标准形式 -
filepath.Join("a", "..", "c")→"a/../c"，filepath.Clean才折叠为"c" -
filepath.Join("log/", "file.txt")→"log//file.txt"，Clean后才是"log/file.txt" - 注意：
filepath.Clean("../etc/passwd")仍返回"../etc/passwd"—— 它不做越界校验，只做字符串规整
用户输入路径必须走 filepath.Abs + 白名单校验
仅靠 Join 和 Clean 无法防御路径穿越。用户传 "../../etc/passwd"，Clean 后还是 "../../etc/passwd"，直接 os.Open 就越界。
- 先调
abs, err := filepath.Abs(input)转成绝对路径（注意：它依赖os.Getwd()，在 CI 或容器中不稳定） - 更可靠的做法是锚定二进制位置：
exePath, _ := os.Executable()→exeDir := filepath.Dir(exePath)→ 再filepath.Join(exeDir, input) - 白名单校验必须用
strings.HasPrefix(cleaned, allowRoot+string(filepath.Separator))，结尾加分隔符防前缀绕过（如allowRoot="/opt/app"不加/会误放行/opt/app_hacked/config.yaml） -
filepath.Base("log/")返回空字符串，filepath.Dir("singlefile")返回"."—— 提取前务必先Clean，再用strings.HasSuffix判断是否为目录
别把 path 和 filepath 混用
path 包只认 /，完全无视 \。在 Windows 上解析 "C:\foo\bar.exe" 会返回 "."，不是你想要的目录。它的用途极窄：只适合处理 HTTP 路由路径（如 r.Path = "/api/v1/users"）。
立即学习“go语言免费学习笔记（深入）”；
- 所有本地磁盘 I/O 操作（
os.Open、ioutil.ReadFile、exec.Command参数）必须用filepath包 -
filepath.Dir和filepath.Base行为跨平台一致，但返回值风格随系统走（Linux 返回/a/b，Windows 返回C:\a\b），这是设计使然，不是 bug - 符号链接需真实物理路径比对时，顺序必须是：
filepath.Abs→filepath.EvalSymlinks；反序可能因相对路径找不到起点而失败；Windows 下对 junction 支持有限，别依赖它 100% 成功
filepath.Join 拼、filepath.Clean 规范、os.Executable 定基准、白名单校验防越界——漏掉任意一环，都可能在 Windows 或 CI 环境里突然崩掉。 
