filepath.Join是Go跨平台路径拼接唯一安全方式，自动适配系统分隔符、忽略空字符串和"."，但遇绝对路径即重置、不折叠".."、不访问文件系统；须配合Clean和Abs实现完整路径安全闭环。
Go 语言本身不强制要求你写死路径分隔符，但硬编码 / 或 \、用 + 拼接路径、或依赖当前工作目录（os.Getwd()）读配置，都会在跨平台时出问题——不是报错，而是静默读错文件、越界访问、或路径不存在。
filepath.Join 是路径拼接的唯一安全方式
它自动适配当前系统：Linux/macOS 输出 /，Windows 输出 \（实际内核也接受 /，但语义清晰且避免混合分隔符）。字符串拼接如 "config" + "/" + "app.yaml" 在 Windows 上可能生成 config/app.yaml，虽能被部分 API 接受，但遇到 exec.Command 调用外部工具（如 PowerShell 或 cmd.exe）时容易失败。
-
filepath.Join("data", "logs", "app.log")→ Linux:data/logs/app.log，Windows:data\logs\app.log - 不要在循环中高频调用；基础路径提前拼好复用，比如
logDir := filepath.Join(root, "logs") - 它不清理冗余：
filepath.Join("a//b", "c")得到a//b/c，不是a/b/c；需要规范化请补filepath.Clean
filepath.Abs 和 filepath.Clean 必须配合使用
用户输入路径、命令行参数传入的路径、或配置文件里写的相对路径，不能直接 os.Open。先 filepath.Abs 转成绝对路径，再 filepath.Clean 归一化，最后做白名单校验（比如是否以允许根目录开头）。
-
filepath.Clean("../etc/passwd")返回../etc/passwd，不检查是否存在，也不转绝对路径 -
abs, _ := filepath.Abs("../etc/passwd")返回类似/home/user/../etc/passwd，此时再filepath.Clean(abs)才得到/etc/passwd - 若允许路径必须落在
/opt/myapp下，则校验strings.HasPrefix(cleanedAbs, "/opt/myapp"+string(filepath.Separator))
程序自身所在目录不能靠 os.Getwd()
os.Getwd() 返回的是进程启动时的工作目录，不是二进制或源码所在位置。本地 go run main.go 可能正常，但打包后在别处执行就崩。
立即学习“go语言免费学习笔记（深入）”；
- 用
runtime.Caller(0)获取当前文件（如main.go）的绝对路径，再filepath.Dir得到源码目录 - 用
os.Executable()获取运行时二进制路径（适用于已编译程序），注意它返回的是符号链接目标，需filepath.EvalSymlinks处理 - 二者结果不同：
go run场景下前者指向.go文件，后者指向临时编译路径，所以优先用runtime.Caller(0)保证调试与发布行为一致
filepath.Base 和 filepath.Dir 的边界行为极易踩坑
它们按分隔符切分字符串，不感知文件系统状态，也不判断“是不是目录”。比如 filepath.Base("log/") 返回空字符串 ""，不是 "log"；filepath.Dir("singlefile") 返回 "."，不是 ""。
- 提取真实文件名前，先
filepath.Clean(path)，再检查末尾是否为分隔符（strings.HasSuffix(cleaned, string(filepath.Separator))） - 拼新扩展名时别直接
filepath.Base(p) + ".bak"，应先filepath.Base(filepath.Clean(p))再操作 -
filepath.Dir返回"."时，后续filepath.Join(dir, "sub")会变成./sub，在某些上下文（如 Docker volume mount）可能意外解析失败
最危险的不是路径拼错，而是路径越界却没被拦截——filepath.Clean 不等于路径安全，filepath.Abs 也不等于路径合法。任何来自外部的路径输入，都必须走“绝对化 → 清洗 → 白名单校验”三步，缺一不可。
