filepath是Go跨平台路径处理的强制标准，自动适配分隔符；Clean仅字符串归一化不校验安全性；Abs+白名单校验防目录穿越；os.Stat才是路径可访问性的唯一真相。
filepath 是跨平台文件路径处理的唯一可靠选择
Go 中处理本地文件系统路径，filepath 不是“可选工具”，而是强制标准——它自动适配 os.PathSeparator（Windows 用 \，Linux/macOS 用 /），所有 os.Open、os.Stat、ioutil.ReadFile 等 I/O 操作都依赖它生成的合法路径字符串。用 path.Join 或字符串拼接（如 "dir/" + "file.txt"）在 Windows 上极易产出混合分隔符（C:/a\b.txt），导致静默失败或权限错误。
-
filepath.Join("logs", "2024", "app.log")在 Windows 输出logs\2024\app.log，Linux 输出logs/2024/app.log - 传入含斜杠的片段（如
"data/"和"config.json"）会被自动归一化，无需手动 trim - 空字符串参数被忽略：
filepath.Join("a", "", "b")→"a/b"
Clean 只规范，不校验：别把它当安全网
filepath.Clean 是纯字符串操作，只做三件事：合并重复分隔符、消除 .、应用 ..（只要前面有可退段）。它**完全不检查路径是否存在、是否越界、是否含非法字符**。比如 filepath.Clean("../etc/passwd") 返回 "../etc/passwd"，看起来“干净”了，但实际已逃出你的服务根目录。
- 常见误用：仅靠
Clean防目录穿越 → 必然失效 - 正确做法：先
filepath.Abs(filepath.Join(root, userInput))，再用strings.HasPrefix(absPath, cleanRoot+string(filepath.Separator))白名单比对 -
Clean("C:\\a\\..\\b")→"C:\\b"（保留盘符），而Clean("/../a")→"/a"（根外部分被截断）
os.Stat 才是路径“可访问性”的唯一真相
只有 os.Stat（或 os.Open）能真实反映操作系统层面的状态：路径是否存在、是否有权限、是否超长、是否含 NUL 字节或 Windows 保留名（如 AUX、CON）。其他任何函数（Clean、IsAbs、Ext）都只是字符串游戏。
-
os.Stat可能返回syscall.ENAMETOOLONG（路径过长）、syscall.EACCES（无权访问）、nil（存在且可读） - Windows 下打开
"CON.txt"可能静默失败或报"Invalid argument"，Clean完全无法捕获 - 性能注意：频繁调用
os.Stat有系统调用开销，只应在关键入口（如文件上传保存前）使用
Dir/Base/Ext 解析必须配合 Clean 或 Abs 使用
filepath.Dir、filepath.Base、filepath.Ext 是纯字符串切分函数，不处理路径语义。对 "a/../b.txt" 直接调用 Base 得到 "b.txt"，看似没问题，但若未先 Clean，真实路径可能是 "/etc/shadow" —— 解析结果完全失真。
立即学习“go语言免费学习笔记（深入）”；
- 安全流程：用户输入 →
filepath.Clean→filepath.Abs→ 再用Dir/Base/Ext -
filepath.Base("C:\\Windows\\System32\\notepad.exe")→"notepad.exe"（跨平台一致） -
filepath.Ext(".gitignore")→""（点开头不算扩展名），filepath.Ext("archive.tar.gz")→".gz"
Clean 和 Abs 是两道必要但不充分的工序，os.Stat 是最终拍板者，而所有这些步骤的前提，是永远不把用户输入直接塞进 Join 后就去打开文件。 
