必须用filepath.Join；path.Join仅适用于URL等字符串路径，混用会导致Windows下os.OpenFile失败，因前者生成系统原生分隔符路径，后者生成Unix风格路径且不被部分syscall正确解析。
Windows 上用 path.Join 拼路径传给 os.OpenFile，十有八九会失败——不是 Go 不支持反斜杠，而是你用错了包。
path.Join 和 filepath.Join 到底该用谁
看路径最终去哪：
→ 要写磁盘、建目录、打开文件、调 os.Stat？必须用 filepath.Join。
→ 要拼 HTTP URL、JSON 配置里的 "log_path" 字段、ZIP 内部路径、或日志里打印“看着像路径”的字符串？用 path.Join。
混用后果很直接：path.Join("logs", "app.log") 在 Windows 上返回 "logs/app.log"，但旧版 Go 或某些 syscall 场景下，os.OpenFile 会拒绝这个路径（尤其涉及 UNC 或驱动器根时）；而 filepath.Join 在 Windows 返回 "logs\app.log"，Linux 返回 "logs/app.log"，且能被所有系统调用正确解析。
filepath.Clean 不处理 /，这是设计使然
filepath.Clean 只识别当前系统的分隔符：
• Linux/macOS 下只处理 /，忽略 \
• Windows 下只处理 \，对输入里的 / 视而不见
所以 filepath.Clean("a//b/c") 在 Windows 上还是 "a//b/c"，不是 "a\b\c"。
正确做法是先转义再清理：
• 输入含 /（比如从 JSON 或 API 来的）：用 filepath.FromSlash 转成本地分隔符，再 Clean
• 输出要跨平台显示（比如日志、调试）：用 filepath.ToSlash 统一成 /
示例：filepath.Clean(filepath.FromSlash("logs//error.log")) → "logs\error.log"（Windows）
filepath.Join 遇到绝对路径就丢前面所有内容
filepath.Join 不是字符串拼接，它是路径语义归一化：
• filepath.Join("config", "/etc/app.yaml") → "/etc/app.yaml"（Linux）
• filepath.Join("config", "C:\tmp\log.txt") → "C:\tmp\log.txt"（Windows）
也就是说，只要某一段是绝对路径，前面全作废。
常见坑：
• 用户配置项 log_dir: "/var/log"，代码却写 filepath.Join(config.LogDir, "app.log") → 实际只用了 "app.log"，写进当前目录
防范方式：
• 拼之前用 filepath.IsAbs 检查
• 更稳妥：统一先 filepath.Abs 或 filepath.Clean 标准化，再决定是否参与 Join
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
立即学习“go语言免费学习笔记（深入）”；
os.OpenFile 报 “no such file or directory” 却文件明明存在
这不是路径不存在，而是路径没标准化或父目录根本没创建：
• filepath.Join("logs", "2024", "app.log") 返回 "logs\2024\app.log"（Windows），但 logs\2024 目录可能压根没 os.MkdirAll 过
• 路径含 .. 或开头是 ../，filepath.Clean 后仍合法，但实际越权访问了不该碰的目录
排查建议：
• 先用 filepath.Abs(path) 打印出真实绝对路径，肉眼确认是否符合预期
• 对用户输入或配置路径，Clean 后检查是否以允许根目录开头（如 strings.HasPrefix(abs, allowRoot)）
• 敏感操作前务必 os.MkdirAll(filepath.Dir(path), 0755)
最常被忽略的一点：路径操作不等于路径安全。Clean 不校验存在性，Join 不自动建目录，IsAbs 不防越界——这些都得你手动补全逻辑，不能指望包替你兜底。
