应使用 filepath 包而非字符串拼接构造路径，因其自动适配 GOOS 的分隔符与规则；路径操作须用 filepath.Join、Clean、Abs 和 EvalSymlinks（顺序不可颠倒）；区分 filepath（文件系统）与 path（纯字符串/URL）；读写前务必用 os.Stat 校验存在性与权限。
用 filepath 而不是字符串拼接
硬拼 "./config/" + filename 或 "C:\data\" + name 在跨平台时必然出错。Windows 用反斜杠，Linux/macOS 用正斜杠，而且路径分隔符语义、盘符、UNC 路径等处理完全不同。filepath 包会根据运行时 GOOS 自动适配分隔符和规则。
实操建议：
- 所有路径构造必须走
filepath.Join()，它会自动合并冗余分隔符、处理空段、适配系统 - 避免用
strings.Replace或strings.Split处理路径字符串 —— 它们不理解路径语义（比如..归一化、大小写敏感性） - 读取用户输入的路径（如命令行参数）后，第一时间用
filepath.Clean()规范化
filepath.Abs() 和 filepath.EvalSymlinks() 的调用顺序很重要
想获得一个“最终、绝对、真实”的路径，不能只调用 filepath.Abs()。它只做相对转绝对，不解析符号链接；而 filepath.EvalSymlinks() 只解析符号链接，但要求输入已是绝对路径。顺序错了就可能拿到错误结果。
正确做法是：
立即学习“go语言免费学习笔记（深入）”；
- 先用
filepath.Abs()得到绝对路径 - 再用
filepath.EvalSymlinks()解析其中所有符号链接 - 如果要兼容 Windows 的重解析点（如目录交接点），需额外调用
os.Stat()判断是否为os.ModeSymlink，因为EvalSymlinks在 Windows 上默认不处理它们
path := "./conf/../config.yaml" abs, _ := filepath.Abs(path) real, _ := filepath.EvalSymlinks(abs) // real 是干净、绝对、无符号链接的真实路径
区分 filepath 和 path 包的使用场景
path 包是纯字符串操作，不关心操作系统，适用于 URL 路径或 POSIX 风格的虚拟路径（比如模板渲染、HTTP 路由匹配）。filepath 才是处理真实文件系统路径的唯一选择。
常见误用：
- 用
path.Join()拼接磁盘路径 → 在 Windows 上生成"C:/a/b"，但某些 API（如os.Open）在 Windows 下可能拒绝该格式（期待"C:\a\b"或接受但行为不一致） - 把
filepath.Base()结果直接用于 URL 构造 → 可能含非法字符（如空格、中文），没做 URL 编码 - 混淆
filepath.Dir()和path.Dir()：前者返回"C:\data"（Windows），后者返回"C:/data"，传给os.Stat()时后者可能失败
读写文件前务必检查路径是否存在且可访问
跨平台下，路径存在性、权限、大小写敏感性差异很大：macOS 默认大小写不敏感，Linux 敏感，Windows 文件系统层不敏感但 Go 运行时行为受底层 syscall 影响。别假设 filepath.Join("config", "app.yaml") 一定可读。
安全做法：
- 用
os.Stat()检查路径是否存在、是否为文件、是否有读/写权限，而不是靠os.IsNotExist()错误判断 - 对用户配置的根目录（如
--data-dir），在程序启动时就os.Stat()+os.IsDir()校验，失败立即退出并提示具体路径 - 注意：
os.MkdirAll()不保证父目录可写 —— 如果中间某级是只读目录，它会失败，需逐级检查权限
路径处理最麻烦的从来不是拼接，而是“你以为它存在，其实它被挂载在另一个卷上”或者“它是个指向不存在目标的符号链接”。多一次 os.Stat() 换来的确定性，远比事后 debug 强。
