必须用filepath.Join拼接本地文件路径，因其自动适配系统分隔符、去重冗余斜杠、支持绝对路径重置语义；其他方式如+或fmt.Sprintf易导致跨平台路径错误或安全漏洞。
filepath.Join 是唯一安全的跨平台路径拼接方式，其他任何字符串拼接（+、fmt.Sprintf）在 Windows 上大概率导致 no such file or directory 或静默读错文件——这不是兼容性“建议”，是硬性要求。
为什么必须用 filepath.Join 拼路径，而不是 + 或 fmt.Sprintf
字符串拼接完全不感知操作系统语义："config" + "/" + "app.yaml" 在 Windows 上生成 config/app.yaml，部分系统调用能容忍，但遇到 exec.Command 调用 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遇到绝对路径就“重置”，这是设计行为：任意参数是绝对路径（如"/etc/hosts"或"C:\tmp"），前面所有参数都会被丢弃
filepath.Abs 不该作为跨平台起点，要用 os.Executable 锚定基准
filepath.Abs 强依赖 os.Getwd()，而工作目录在 Windows 各盘符独立、在容器或 IDE 中易变，导致路径结构不可比、白名单校验失效。比如 filepath.Abs("config.yaml") 在 CI 环境返回 /workspace/config.yaml，本地却是 /home/user/project/config.yaml，前缀不同直接校验失败。
- 正确做法：先
execPath, _ := os.Executable()，再execDir := filepath.Dir(execPath) - 用
filepath.Join(execDir, "etc", "app.conf")拼目标路径，永远不用+或fmt.Sprintf - 若需处理符号链接（如 Docker 挂载的 config 目录），顺序必须是：Join →
filepath.Abs→filepath.EvalSymlinks；反序会导致EvalSymlinks因相对路径找不到起点而失败 -
filepath.EvalSymlinks在 Windows 对 junction 支持有限，某些情况静默失败，别依赖它做关键判定
用户输入路径必须走 filepath.Abs + filepath.Clean + 白名单校验
filepath.Clean 只做字符串归一化，不检查存在性，也不转绝对路径：filepath.Clean("../etc/passwd") 仍返回 "../etc/passwd"。直接 os.Open 它，可能越界读取敏感文件。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 先
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输入，再判断是否以/结尾 - 别在循环里高频调用
Join+Clean+Abs；基础路径（如日志根目录）提前算好复用
别混淆 path 和 filepath 包
path 包专为 slash-only 的 URI/URL 路径设计（如 /api/v1/users），filepath 是为操作系统路径服务的。混用会导致 Windows 下路径爆炸：path.Join("C:", "foo") 得到 "C:/foo"，而系统期待 "C:\foo"。
立即学习“go语言免费学习笔记（深入）”；
- 读写文件、调用
os.Stat？必须用filepath - 处理 HTTP 路由、URL 查询参数里的路径？用
path.Clean、path.Join - 没有“跨平台通用路径包”——Go 明确拆开，是因为语义根本不同
-
filepath.IsAbs判断结果依赖运行环境，cross-compiling 时容易误判，别用于静态分析
filepath.Clean 当作安全过滤器，或在没 Abs 前就做白名单判断——这两步漏掉任何一个，都可能让越界读写在某个平台静默发生。 
