filepath.join拼出非预期路径的主因是参数含绝对路径，此时会丢弃前面所有参数直接返回该绝对路径；必须先clean再join，且敏感操作前须abs+evalsymlinks校验。
filepath.Join 拼出来不是你想要的路径？先看参数里有没有绝对路径
这是最常踩的坑：只要 filepath.Join 的任意一个参数是绝对路径（比如 "/etc/config.yaml" 或 "C:\tmp\file.txt"），它就会丢弃前面所有参数，直接返回那个绝对路径。这不是 bug，是明确设计行为。
常见错误现象：
-
filepath.Join("app", "/data/file.txt")→"/data/file.txt"（Linux/macOS）或"C:\data\file.txt"（Windows 当前盘符下） -
filepath.Join("root", "sub", "C:/config.yaml")→"C:\config.yaml"，完全忽略"root/sub"
实操建议：
- 对用户输入、配置项、环境变量读取的路径，**必须先调用
filepath.Clean**，再传给Join - 避免在
Join中混入硬编码的绝对路径字符串；如需拼接绝对路径，应先filepath.Dir提取其父目录，再Join子路径 - 调试时可用
fmt.Printf("raw: %q, clean: %q", input, filepath.Clean(input))快速验证输入是否含越界符号
filepath.Base 和 filepath.Dir 对末尾斜杠极其敏感
filepath.Base 不是“取文件名”，而是“取最后一个路径段”；filepath.Dir 也不是“取上级目录”，而是“去掉 Base 后剩下的部分”。两者都按分隔符切分，不自动清理输入。
典型边界行为：
-
filepath.Base("log/")→""（空字符串），不是"log" -
filepath.Base("/home/user/")→""，filepath.Base("/")→"/" -
filepath.Dir("singlefile")→"."，不是""；filepath.Dir("/")→"/"
实操建议：
- 对用户传入的路径，**务必先
filepath.Clean再调用Base或Dir**，否则filepath.Base("../etc/passwd")会返回"passwd"，掩盖路径穿越风险 - 若需确保提取的是真实文件名（非空），可组合判断：
base := filepath.Base(path); if base == "" { base = filepath.Base(filepath.Dir(path)) } - 不要依赖
Dir返回值是否为空来判断是否为根目录——filepath.Dir("/a")是"/"，filepath.Dir("/")也是"/"
敏感操作前必须走 filepath.Abs + filepath.EvalSymlinks
仅靠 Join 和 Clean 无法确认路径真实指向哪里。要防符号链接逃逸、做白名单校验、或判断两个路径是否等价，必须走这一步。
关键细节：
-
filepath.Abs只是把相对路径转成当前工作目录下的绝对路径字符串，**不检查存在性，也不解析软链** -
filepath.EvalSymlinks要求路径**真实存在**，并逐级展开所有符号链接；传入不存在的路径会报错 - 顺序不能反：必须先
Abs，再EvalSymlinks；否则相对路径传给EvalSymlinks会因找不到起点而失败 - Windows 下对 junction、hard link 支持有限，可能静默失败，别依赖它做关键路径判定
实操建议：
- 读配置、写日志、解压归档等敏感操作前，加一层校验：
abs, _ := filepath.Abs(userPath); real, _ := filepath.EvalSymlinks(abs) - 白名单校验推荐用字符串前缀比较：
strings.HasPrefix(real, allowedRoot)，且allowedRoot本身也需是EvalSymlinks后的真实路径 - 注意：如果程序运行在沙盒环境（如 macOS App Bundle）、容器或受限权限目录，
EvalSymlinks可能因权限不足失败，需有 fallback 逻辑
跨平台桌面路径不能硬编码，优先用 adrg/xdg
桌面路径不是固定位置：%USERPROFILE%Desktop（Windows）、~/Desktop（macOS/Linux），还可能被用户重定向（如 OneDrive 同步桌面）。硬编码 "./Desktop" 或 "~/Desktop" 在打包、沙盒、UAC 场景下必然失败。
实操建议：
- 首选
github.com/adrg/xdg：它严格遵循 XDG 规范，并自动适配 Windows/macOS，支持xdg.UserDirs.Desktop获取真实路径 - 不用
os.UserHomeDir()拼接"Desktop"—— Linux 发行版可能映射到~/桌面，macOS 可能被本地化为~/Escritorio，且不处理 OneDrive 重定向 - 获取路径后，**必须配合
os.MkdirAll创建目录**（桌面目录可能尚未创建），再写文件；不要假设目录一定存在 - 若因合规限制不能引入第三方库，退而求其次用
os.Getenv("USERPROFILE") + "\Desktop"（Windows）和os.Getenv("HOME") + "/Desktop"（其他系统），但需加os.Stat校验存在性与可写性
Clean）和符号链接解析（EvalSymlinks）必须在同一个上下文里完成，且不能跳过任何一环**。少做一次 Clean，就可能让 ../etc/shadow 逃过校验；少做一次 EvalSymlinks，就可能让软链绕过白名单。这两步不是可选项，是生产环境的强制前置动作。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
