Go中拼接本地文件路径必须用filepath.Join，Web/URL路径用path.Join；混用会导致跨平台失效、路径遍历漏洞及安全风险，字符串拼接（如+或fmt.Sprintf）严禁用于文件路径。
Go 中拼接文件路径必须区分用途：本地文件系统用 path/filepath.Join，Web/URL 路径用 path.Join。混用会导致路径错乱、跨平台失效甚至安全漏洞。
filepath.Join 是处理本地文件路径的唯一推荐方式
它不是“可选优化”，而是强制要求——所有涉及 os.Open、os.Stat、os.ReadDir 等文件系统操作的路径拼接，都必须走 filepath.Join。
- 自动适配分隔符：
filepath.Join("config", "db.yaml")在 Windows 返回configdb.yaml，Linux/macOS 返回config/db.yaml - 规范化相对路径：
filepath.Join("a/b", "..", "c")→a/c，而字符串拼接会得到a/b/../c（可能绕过访问控制） - 裁掉非法前缀：
filepath.Join("data", "/etc/passwd")直接返回/etc/passwd（首个参数是绝对路径时，后续全被忽略），所以务必确保传入的文件名是干净的相对名（如来自entry.Name()）
path.Join 仅适用于 URL、HTTP 路由等纯字符串路径
path.Join 不关心操作系统，只做 Unix 风格斜杠的字符串归一化。它不能用于打开本地文件，否则在 Windows 上会因分隔符错误导致 open a.txt: no such file or directory。
- 适用场景：构造 API 请求路径
path.Join("/api", "v1", "users")→/api/v1/users - 不适用场景：
os.Open(path.Join("logs", "app.log"))—— 这在 Windows 下实际尝试打开logs/app.log（用/），但系统期望，或更糟：当前盘符下找logs/app.log - 它不会处理
..跨越根目录的问题，也不识别驱动器前缀（C:）或 UNC 路径（\servershare）
常见错误：用 fmt.Sprintf 或 + 拼接路径
这类写法看似简洁，实则埋下三类隐患：平台兼容性断裂、路径遍历漏洞、调试困难。
立即学习“go语言免费学习笔记（深入）”；
-
os.Open("./XML/" + filename)：若filename == "../etc/shadow"，就变成./XML/../etc/shadow，filepath.Join会规范为./etc/shadow，而字符串拼接保留原样，可能越权读取 -
fmt.Sprintf("%s/%s", dir, name)：硬编码/，Windows 下生成非法路径；且无法处理dir结尾已有/的情况，导致双斜杠//，某些旧版工具可能解析异常 - 调试时打印出的路径不可信：字符串拼接结果无法直接复制到 shell 中执行验证，而
filepath.Join输出的是真实可用路径
实际项目中容易被忽略的细节
即使用了 filepath.Join，仍可能因上下文误用而失败。关键点不在函数本身，而在输入来源和调用时机。
- 服务部署后工作目录常为
/，filepath.Join("conf", "app.yaml")实际指向/conf/app.yaml，而非项目根目录下的conf/—— 应先用os.Getwd()或传入明确基路径 - 循环中用
defer file.Close()会导致所有文件句柄延迟到函数退出才释放，应改用匿名函数立即执行：func() { defer file.Close(); /* 处理 */ }() - 日志里打印路径时，建议统一转成正斜杠：
filepath.ToSlash(fullPath)，避免 Windows 日志中出现被误解析为转义字符
