应使用 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 才是处理真实文件系统路径的唯一选择。
MayiCMS·蚂蚁分类信息系统是一款基于PHP+MYSQL（PC+手机+小程序+APP，跨平台、跨终端）的建站软件，拥有专业且完善的信息审核机制，信息刷新/置顶消费机制，信息分享/发布奖励机制，信息查看/付费授权机制，会员等级自助续费机制，为在各种类型操作系统服务器上架设信息发布平台提供完美的解决方案，拥有世界一流的用户体验，卓越的访问速度和负载能力。功能特点：1，PC手机自适应，URL路径完全
常见误用：
- 用
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 强。
