filepath.Join是唯一安全的跨平台路径拼接方式，自动适配分隔符、处理空字符串和“.”，但需配合Clean、Abs和白名单校验防范路径穿越；硬编码分隔符、字符串拼接或传入含分隔符的子路径均不安全。
filepath.Join 是唯一安全的路径拼接方式
硬编码 / 或 、用 + 拼字符串、甚至 fmt.Sprintf，在 Windows 上大概率触发 no such file or directory —— 不是报错，而是静默读错位置或写到奇怪目录。真正能跨平台的只有 filepath.Join。
它自动适配分隔符：filepath.Join("data", "logs", "app.log") 在 Linux 输出 data/logs/app.log，在 Windows 输出 datalogspp.log；还跳过空字符串和 "."，合并冗余分隔符（"a//b" → "a/b"）。
- ❌ 错误写法：
dir + "/config.yaml"、"C: mp ile.txt"（反斜杠需转义）、filepath.Join(base, "sub/dir/file.txt")（含分隔符的字符串不该传进去） - ✅ 正确拆解：
filepath.Join(base, "sub", "dir", "file.txt") - ⚠️ 注意：
filepath.Join("a", "/etc/passwd")直接返回/etc/passwd（Linux）或C: etc/passwd（Windows），前面参数全丢——这是设计行为，不是 bug
用户输入路径必须先 Clean 再 Abs
filepath.Join 只负责拼，不解析语义；filepath.Clean 只做字符串归一化（压缩 ./、../），但不访问磁盘、不校验存在性。对命令行参数、配置文件读入、HTTP 路径等不可信输入，直接 os.Open 极易越界。
- 危险示例：
filepath.Clean("../etc/passwd")返回../etc/passwd，os.Open仍可能打开系统文件 - 安全流程：先
filepath.Clean(input)→ 再filepath.Abs(cleaned)→ 最后校验是否落在白名单根目录内，比如strings.HasPrefix(abs, allowRoot+string(filepath.Separator)) - Windows 盘符特殊：
filepath.Join("C:", "foo")得到C:foo（相对路径），要绝对路径得写filepath.Join("C:\", "foo")或filepath.Join("C:/", "foo")
别依赖 os.Getwd() 获取程序根目录
os.Getwd() 返回的是进程启动时的工作目录，不是二进制所在位置，也不是源码目录。CI/CD、systemd、桌面快捷方式启动时，这个值完全不可控。
立即学习“go语言免费学习笔记（深入）”；
- 正确做法：用
os.Executable()+filepath.Dir获取二进制所在目录，再拼子路径 - 示例：
exe, _ := os.Executable() root := filepath.Dir(exe) configPath := filepath.Join(root, "config.yaml")
- 临时目录统一用
os.TempDir()，它自动返回%TEMP%（Windows）、/tmp（Linux）、/var/folders/...（macOS）
跨平台执行命令时路径要显式处理
调用外部命令（如 exec.Command）时，即使路径本身用 filepath.Join 拼对了，Windows 下仍可能因 shell 差异失败：直接执行 .sh 文件会报错，cmd /c 和 PowerShell -Command 对路径格式敏感。
- 可执行文件后缀要补：
name + exeSuffix()，其中func exeSuffix() string { if runtime.GOOS == "windows" { return ".exe" }; return "" } - 避免传入带空格或特殊字符的路径给
exec.Command，优先用exec.LookPath查找，再传绝对路径 - 脚本类命令（如
bash -c）在 Windows 需改用cmd /c或PowerShell -Command，且路径中易被当成转义符，建议统一用正斜杠或双反斜杠
Join + Clean + Abs + 白名单校验这四步缺一不可。漏掉任意一环，都可能在某个平台静默越界。 
