filepath.join 是唯一安全的路径拼接方式，它自动适配平台分隔符、规范路径结构，并在遇到绝对路径时直接返回该路径；所有文件系统操作必须用 filepath 包而非 path，用户输入路径需经 abs、clean 和白名单校验三步闭环。
filepath.Join 是唯一安全的路径拼接方式
硬编码 / 或 、用 + 拼字符串、甚至 fmt.Sprintf 构造路径，在跨平台场景下几乎必然出错。Windows 上可能生成 C: oo/bar.txt 这类混合分隔符，os.Stat 有时能容忍，但 exec.Command 调外部工具（如 cmd.exe 或 PowerShell）时大概率失败，报错 no such file or directory 却找不到原因。
正确做法只有一种：filepath.Join("dir", "sub", "file.txt")。它自动使用 filepath.Separator（Linux/macOS 是 /，Windows 是 ），同时做基础规范化：清理末尾斜杠、忽略空字符串和 .、保留 .. 不解析（这是设计，不是 bug）。
-
filepath.Join("a/", "b")→a/b（Linux）或a（Windows） -
filepath.Join("a", "..", "b")→a/../b，不是b；需后续调filepath.Clean -
filepath.Join("C:", "foo")→C:foo（相对路径！不是C: oo） - 要拼盘符绝对路径，写
filepath.Join("C:/", "foo")或filepath.Join("C:\", "foo")，/更安全，filepath.Join会自动转义
绝对路径参数会直接覆盖前面所有路径
filepath.Join 遇到任意参数是绝对路径（如 /etc/config.yaml 或 C: mplog），会丢弃之前所有参数，直接返回该绝对路径。这不是 bug，是明确设计行为。
常见陷阱是配置项里混入了用户输入的绝对路径，比如读取 YAML 中的 log_path: "/var/log/app"，然后写成 filepath.Join(baseDir, config.LogPath)——结果 baseDir 完全被忽略，程序悄悄写到了系统目录。
- 若必须拼接，先用
filepath.Clean(config.LogPath)归一化，再判断是否为绝对路径：filepath.IsAbs(cleaned) - 非绝对路径才走
filepath.Join(baseDir, cleaned) - 绝对路径也要校验范围，比如限制只能以
/opt/myapp或C:Program FilesMyApp开头
解析路径必须用 filepath 包，不能用 path
path.Dir("c: ooar.exe") 在 Windows 上返回 .，完全不可用。因为 path 包只认 /，把 当普通字符处理，根本无法解析本地文件路径。
所有与操作系统文件系统交互的路径操作，一律用 filepath：获取目录用 filepath.Dir，提取文件名用 filepath.Base，取扩展名用 filepath.Ext，拆分路径段用 filepath.Split。
- HTTP 请求中收到的路径（如
/api/v1/files?path=../etc/passwd）是 URL 风格，先用path.Clean，再传给filepath.FromSlash转成本地格式 - 不要对
filepath.Join结果做strings.Split(path, "/")—— Windows 下整个路径会被当做一个元素 - 显示或日志中需要统一格式，用
filepath.ToSlash(path)，但仅限非系统调用场景
用户输入路径必须过 Abs + Clean + 白名单校验
filepath.Clean("../etc/passwd") 只是字符串归一化，返回仍是 ../etc/passwd，不检查是否存在，也不转绝对路径。直接传给 os.Open 就可能越界读取敏感文件。
安全闭环必须三步走：filepath.Abs → filepath.Clean → 白名单前缀校验。
-
abs, _ := filepath.Abs(userInput)得到类似/home/user/../etc/passwd -
cleaned := filepath.Clean(abs)才得到/etc/passwd - 再判断
strings.HasPrefix(cleaned, allowedRoot+string(filepath.Separator))，比如/opt/myapp/ - 注意：程序自身所在目录不能靠
os.Getwd()，它返回的是启动工作目录，不是二进制位置；要用os.Executable()+filepath.Dir
filepath.Join 写对了，上游参数没过滤、下游调用没校验，照样在 Windows 上静默失败，或在 Linux 上越权访问。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
