Go 的 path/filepath 在 Windows 上拼路径出错是因为直接用 "/" 或 "" 拼接绕过标准化逻辑，导致非法路径；必须用 filepath.Join() 处理变量路径，它自动选分隔符并清理冗余和 ".."。
Go 的 path/filepath 为什么在 Windows 上拼路径会出错？
因为直接用 "/" 或 "" 拼接路径，绕过了 filepath 的标准化逻辑，导致跨平台代码在 Windows 上生成非法路径（比如 C: oo/bar.txt），或在 Unix 上出现多余反斜杠。
-
filepath.Join()自动按当前 OS 选分隔符，且会清理冗余分隔符和".." -
filepath.Separator是 rune 类型（'\'或'/'），不能直接当字符串拼接 - 用
strings.Join(parts, string(filepath.Separator))是常见错误——它不处理".."、不清理空段、不转义
什么时候必须用 filepath.Join() 而不是字符串拼接？
只要路径组件来自变量、配置、用户输入或环境，就必须用 filepath.Join()。硬编码的完整路径字面量（如 "./config.yaml"）可读性优先，但一旦含变量就立刻失效。
- 读取命令行参数：
filepath.Join(dirFlag, "data.json")，而不是dirFlag + "/data.json" - 组合用户家目录：
filepath.Join(os.Getenv("HOME"), ".cache", "app")（Linux/macOS）或filepath.Join(os.Getenv("USERPROFILE"), "AppData", "Local", "app")（Windows） - 遍历子目录时：
filepath.Join(root, entry.Name())，避免root + "/" + entry.Name()在 Windows 上变成C: mp/child
filepath.ToSlash() 和 filepath.FromSlash() 的真实用途
它们不是用来“修复路径”，而是做**单向格式转换**：前者把所有分隔符强制转成 '/'（常用于日志、HTTP 路径、跨平台序列化），后者把 '/' 转回当前系统的分隔符（极少用，仅当你明确需要把统一格式再适配本地文件系统时）。
- 日志打印路径时用
filepath.ToSlash(path)，避免 Windows 日志里全是导致解析困难 - 不要对
os.Open()的参数调用ToSlash()——它会让路径在 Windows 上找不到文件 -
FromSlash()几乎只在测试中模拟跨平台行为，生产代码几乎不用
测试跨平台路径逻辑最容易漏掉的点
本地只在 Linux/macOS 运行测试，会掩盖 Windows 下的路径 bug。真正可靠的验证方式是检查 filepath.IsAbs() 和 filepath.Clean() 的行为，而不是肉眼判断字符串是否“看起来对”。
立即学习“go语言免费学习笔记（深入）”；
- 用
filepath.IsAbs(filepath.Join("C:", "foo"))测试 Windows 绝对路径识别（返回false！正确写法是filepath.Join("C:\", "foo")或"C:\foo"） - 测试
filepath.Clean("a/../b")是否返回"b"，而filepath.Clean("a/../../b")在 Windows 上可能返回"..\b"（因驱动器根无法向上越界） - CI 中至少跑一次 Windows runner，用
GOOS=windows go test不够——它不触发真实系统路径逻辑
路径看似简单，但 filepath 的每个函数背后都藏着 OS 差异、驱动器约定和 UNC 路径的特殊规则。写完路径操作后，不妨在另一台系统上快速跑下 filepath.Abs() 和 os.Stat()，比看文档更管用。
