为什么 filepath.Join 不能直接拼接 URL 或绝对路径前缀
因为 filepath.Join 是专为操作系统本地文件路径设计的，它会根据当前 OS 的规则（如 或 /）归一化分隔符，并主动裁掉中间的 .. 和 . —— 但这个逻辑在遇到类似 http://、file:/// 或 windows 驱动器根路径（C:）时会出错。比如：filepath.Join("http://a.com", "api", "v1") 会返回 http://a.compi 1（Windows 下），甚至可能被误判为相对路径而删掉协议头。
- 只对纯本地路径片段做拼接，输入必须是「路径组件」，不是 URI 或带协议的字符串
- 跨平台安全的前提是：所有输入都不含协议、不以
/或C:开头（除非你明确在构造绝对路径） - 若需拼接 URL，请用
net/url；若需处理 Windows UNC 路径（servershare），要单独判断前缀
filepath.Abs 在不同平台返回路径格式不一致怎么办
filepath.Abs 返回的是当前 OS 原生格式的绝对路径：linux/macos 是 /home/user/foo，Windows 是 C:Usersuser oo。这本身没错，但容易在日志、配置或跨平台调试中造成混淆——尤其当你要把路径存进 json 或传给另一个系统时。
- 不要假设输出一定是 unix 风格斜杠；
filepath.ToSlash可强制转成/分隔（仅用于显示或序列化，不影响实际 I/O） - 避免拿
filepath.Abs的结果直接做字符串比较（比如检查是否在某个目录下），应改用filepath.HasPrefix(filepath.Clean(abs), cleanBase)或更稳妥的filepath.Rel判断相对关系 - 在测试中 mock
os.Getwd很关键，否则filepath.Abs行为随执行目录变化，CI 环境容易飘移
用 filepath.Walk 遍历时，为什么有些目录没进去、或者 panic 了
filepath.Walk 默认不处理符号链接，且遇到权限不足、路径不存在、循环软链等情况时，会把错误传给回调函数——但如果你的 WalkFunc 没返回 Error 或直接 panic，整个遍历就停了。
- 务必在
WalkFunc中检查err != nil：对os.ErrPermission可返回nil跳过；对filepath.SkipDir可跳过子树；其他错误建议记录后返回nil继续，而非 panic - 符号链接默认不展开，要遍历目标内容得先用
os.Stat判断是否为 symlink，再手动os.Readlink+filepath.Join构造真实路径 - 注意
filepath.Walk不保证顺序，如需稳定遍历（比如测试断言），先收集路径再sort.Strings
跨平台读写文件时，os.Open 报 no such file or Directory 却路径明明存在
常见原因是路径里混用了硬编码的 / 或 ，或用了 fmt.Sprintf 拼接路径，绕过了 filepath 的标准化逻辑。比如在 Windows 上写 "/tmp/data.txt"，实际会查 C: mpdata.txt（驱动器默认当前盘符），而不是预期的 C:WindowsTemp。
立即学习“go语言免费学习笔记（深入）”；
- 永远用
filepath.Join构造路径，哪怕只有两段；避免+、fmt.Sprintf、strings.Replace等字符串操作 - 打开前先用
filepath.Clean和filepath.Abs打印调试路径，确认它指向你认为的位置 - 注意
os.Create不会自动创建父目录，缺上级目录要先调os.MkdirAll；而filepath.Dir提取父路径时可能返回.，需额外判断
最麻烦的其实是隐式依赖当前工作目录的路径——比如 config.json 这种相对路径，在 service 模式下工作目录可能是 /，和本地开发完全不同。这类路径最好从启动参数或环境变量显式传入，而不是靠 os.Getwd 猜。