filepath.join 是唯一安全的配置路径拼接方式，它自动适配系统分隔符、跳过空串和"."、合并冗余分隔符，但不处理".."、重复"/"或存在性检查，仅是安全起点。
filepath.Join 是唯一安全的配置路径拼接方式
硬编码 /、用 + 或 fmt.Sprintf 拼配置路径，在 Windows 上八成会触发 no such file or directory，不是报错率高，是语义错乱——比如 "config" + "/" + "app.yaml" 在 Windows 生成 config/app.yaml，部分 os.Open 能容忍，但 exec.Command("powershell", "-c", "Get-Content "+path) 直接解析失败。
filepath.Join 自动选分隔符、跳过空串和 "."、合并冗余分隔符（filepath.Join("etc/", "app.conf") → "etc/app.conf"），但它不折叠 ".."、不清理重复 //、也不检查存在性。所以它只是安全起点，不是终点。
- 必须把路径拆成组件传入：❌
filepath.Join(base, "sub/dir/config.yaml")，✅filepath.Join(base, "sub", "dir", "config.yaml") - 任意参数是绝对路径（如
"/etc/app.conf"或"C:\tmp\conf.yaml"），前面所有参数会被丢弃 - 不要在配置加载循环里反复调用；提前算好
configDir := filepath.Join(execDir, "etc")复用
程序自身目录不能靠 os.Getwd()，得用 os.Executable
filepath.Abs("config.yaml") 强依赖 os.Getwd()，而工作目录在容器、IDE、CI 或 Windows 多盘符下极不稳定：go run main.go 和 ./myapp 返回的路径前缀完全不同，导致白名单校验失效、日志路径漂移、甚至读错配置。
正确锚点是二进制自身位置：execPath, _ := os.Executable() → execDir := filepath.Dir(execPath) → configPath := filepath.Join(execDir, "etc", "app.conf")。这个路径与启动方式无关，稳定可比。
- 若需处理 Docker 挂载的符号链接配置目录，顺序必须是：
Join→filepath.Abs→filepath.EvalSymlinks；反序会因相对路径找不到起点而静默失败 -
filepath.EvalSymlinks在 Windows 对 junction 支持有限，某些情况不报错也不生效，别依赖它做关键判定 - Windows 下
os.Executable()返回的是真实路径（非快捷方式或 symlink 目标），更可靠
用户输入或环境变量路径必须走 Clean → Abs → 白名单闭环
用户通过命令行、HTTP 参数或环境变量传来的路径，绝不能直接 os.Open。例如输入 "../../etc/passwd"，filepath.Clean 后仍是 "../../etc/passwd"，os.Open 可能静默越界读取。
必须三步闭环：
- 先
cleaned := filepath.Clean(input)（纯字符串归一化，不访问磁盘） - 再
abs, _ := filepath.Abs(cleaned)（转绝对路径，注意它仍依赖当前os.Getwd()，所以仅限用户输入，不用作程序基准） - 最后用
strings.HasPrefix(abs, allowRoot+string(filepath.Separator))校验，结尾加分隔符防前缀绕过（如allowRoot = "/opt/myapp"必须写成"/opt/myapp" + string(filepath.Separator)）
filepath.Clean("../etc/passwd") 不会变成 /etc/passwd，也不会报错；它只负责字符串层面的 .. 解析和 // 合并。越界风险必须靠 Abs + HasPrefix 防御。
filepath.Base / Dir 提取文件名时容易掉坑
filepath.Base 和 filepath.Dir 不“智能”，只按分隔符切分字符串。常见错误：对 "log/" 调用 Base 返回空字符串，后续拼 ".bak" 得到 ".bak"，而非预期的 "log.bak"；对 "singlefile" 调用 Dir 返回 "."，不是空字符串。
提取真实文件名前，必须：
- 先
cleaned := filepath.Clean(path) - 再用
strings.HasSuffix(cleaned, string(filepath.Separator))判断是否为目录结尾 - 只有非目录结尾时，才用
filepath.Base(cleaned)获取文件名 - 若要拼新扩展名，优先用
filepath.Ext判断旧后缀，避免手动字符串操作
最易被忽略的是：路径末尾带 / 时 Base 返回空——这个空值不会报错，但会导致后续拼接完全错位，且难以调试。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
