必须使用filepath处理本地文件路径，因其能跨平台生成正确分隔符、自动清理路径并支持绝对路径转换；path仅适用于url、路由等纯字符串路径场景。
处理本地文件路径必须用 filepath，不是可选，是必须
如果你在读写磁盘文件、打开配置、遍历目录或调用 os.Open，所有路径都该走 filepath。用 path 拼出来的路径在 Windows 上可能变成 dir/subdir/file.txt，而系统实际期待 dirsubdir ile.txt —— 这会导致 open dir/subdir/file.txt: The system cannot find the path specified 这类错误。
关键点：
-
filepath.Join("a", "b", "c")在 Windows 输出ac，在 Linux 输出a/b/c -
path.Join("a", "b", "c")在所有平台都输出a/b/c，它不看操作系统 -
filepath.Dir("C:\foo\bar.exe")正确返回C: oo；path.Dir("C:\foo\bar.exe")返回.（因为反斜杠被当作文本） - 即使你硬编码了正斜杠，比如
"config/conf.yaml"，也建议仍用filepath.Join—— 它能自动清理冗余斜杠和..，且语义更清晰
path 只适合 URL、路由、ZIP 内部路径这类纯字符串路径
当你处理 HTTP 请求路径、API 路由前缀、或 ZIP/ISO 文件内部的路径结构时，path 才是正确选择。它不关心文件是否存在、也不调用系统 API，只做字符串解析。
典型场景：
- 解析
/api/v1/users/123/profile的目录部分：path.Dir("/api/v1/users/123/profile")→/api/v1/users/123 - 拼接 Web 资源路径：
path.Join("/static", "js", "app.min.js")→/static/js/app.min.js - 清理用户输入的 URL 路径：
path.Clean("/a//b/../c/")→/a/c - 不要用它去解析
os.Args[1]或用户传入的本地文件路径 —— 那些是操作系统原生路径，必须交给filepath
filepath.Abs 和 filepath.Clean 的行为差异容易被忽略
filepath.Abs 不只是加个当前目录前缀，它会先调用 filepath.Clean 规范化路径，再转为绝对路径。这意味着 filepath.Abs("../config.yaml") 不会直接拼成 /current/../config.yaml，而是先变成 /config.yaml（如果当前在根目录下）或更合理的上级路径。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
但注意：filepath.Clean 不验证路径是否存在，也不检查是否为目录还是文件。它只做字符串归一化：
-
filepath.Clean("a/b/../c")→a/c -
filepath.Clean("a//b/./c")→a/b/c -
filepath.Clean("C:\foo\..\bar")（Windows）→C:ar -
filepath.Clean不会把相对路径转成绝对路径；要绝对路径，必须显式调用filepath.Abs
跨平台启动时定位程序目录，别信 os.Executable 的原始输出
os.Executable() 返回的是二进制路径，但它可能是符号链接、相对路径，甚至带 ..。直接对它做 path.Dir 或字符串切分极不可靠。
安全做法是：
- 先用
os.Executable()获取路径 - 立刻用
filepath.Abs转成绝对路径 - 再用
filepath.Dir提取所在目录 - 最后用
filepath.Join拼接配置文件路径
示例：
exePath, _ := os.Executable() exeDir, _ := filepath.Abs(filepath.Dir(exePath)) configPath := filepath.Join(exeDir, "config.yaml")
这个组合在 Windows、Linux、macOS 上都能稳定拿到可执行文件同级的 config.yaml。手动替换斜杠、用 strings.ReplaceAll 或 path.Dir 都会破坏跨平台性。
