filepath用于文件系统路径，自动适配OS分隔符；path仅适用于URL或POSIX路径。文件操作必须用filepath.Join和filepath.Abs，嵌入文件路径须用/且不可拼接。
Go 中 filepath 与 path 包的区别必须分清
处理文件路径时用错包会导致跨平台行为异常。Windows 下的 \ 和 Unix 下的 / 不能靠字符串拼接硬写，否则在 CI 或 Docker 容器里大概率出错。path 包只适用于 URL 或纯 POSIX 风格路径（如 /a/b/c），而真实文件系统路径一律用 filepath——它会自动适配当前 OS 的分隔符和规则。
-
filepath.Join("a", "b", "c")→ Windows 返回a\b\c，Linux 返回a/b/c -
path.Join("a", "b", "c")→ 永远返回a/b/c，在 Windows 上可能无法打开文件 - 读写文件、调用
os.Open、ioutil.ReadFile（或os.ReadFile）前，路径必须经filepath处理
相对路径解析要主动转为绝对路径再使用
Go 不会自动将相对路径（如 ./config.yaml）按执行目录解析，而是按当前工作目录（os.Getwd()）。如果你的程序被 systemd、Docker 或其他进程以不同工作目录启动，./ 就会指向意外位置。
- 用
filepath.Abs("./config.yaml")获取绝对路径，再传给os.ReadFile - 若配置路径来自命令行参数（如
-config config.yaml），也建议先filepath.Abs，避免用户误输相对路径引发静默失败 - 注意：
filepath.Abs会解析符号链接，如需保留原始路径结构，改用filepath.Join(os.Getwd(), arg)
filepath.Clean 不只是去冗余，还影响安全校验逻辑
filepath.Clean 会折叠 .. 和 .，比如 ../../etc/passwd → /etc/passwd。这在 Web 服务中常被用于防御路径遍历攻击，但容易忽略两个关键点：
- 它不验证路径是否存在，也不检查权限，仅做字符串归一化
- 在 Windows 上，
Clean不处理驱动器盘符大小写（C:\和c:\被视为不同根），且对 UNC 路径支持有限 - 正确做法：先
Clean，再判断是否在允许前缀下，例如strings.HasPrefix(cleaned, allowedRoot)，且allowedRoot本身也应是filepath.Clean过的绝对路径
读取嵌入文件（embed.FS）时路径必须用正斜杠
Go 1.16+ 的 embed 包要求所有嵌入路径字面量使用 / 分隔，无论宿主系统。即使你在 Windows 开发，//go:embed assets/** 或 fs.ReadFile("assets/config.json") 中的路径都必须写成 /。
立即学习“go语言免费学习笔记（深入）”；
- 错误写法：
fs.ReadFile("assets\config.json")→ 编译失败或运行时报file does not exist - 嵌入的路径是编译期确定的，不经过
filepath处理，所以也不能用filepath.Join拼接 - 如果需动态构造嵌入路径（如根据变量选文件），只能用
switch或映射表预定义合法值，避免运行时拼错
filepath.Abs 或 filepath.Clean 成本极低，但能避开 90% 的跨环境路径故障。 
