filepath.walkdir替代walk可处理符号链接且性能更优，需用fs.direntry判断并手动解析；遍历时修改目录结构应两阶段操作；路径拼接须用filepath.join并校验绝对路径，跨平台操作必须使用filepath包api。
filepath.Walk 会跳过符号链接，需要显式处理
默认情况下 filepath.Walk 不会进入符号链接指向的目标路径，而是直接跳过——这常导致遍历时漏掉实际存在的子目录或文件。如果你的项目目录里有软链（比如 node_modules 指向全局缓存），用它就可能读不全。
解决办法是改用 filepath.WalkDir（Go 1.16+），它返回 fs.DirEntry，能通过 entry.Type().IsSymlink() 判断是否为符号链接，并手动调用 os.Readlink 和 filepath.Join 构造真实路径后递归处理。
- 旧代码用
filepath.Walk且需兼容符号链接时，必须自己实现递归逻辑 -
filepath.WalkDir更轻量（不强制 Stat 每个条目），性能更好，推荐新项目直接用它 - 注意：
filepath.WalkDir的回调函数签名是func(path string, d fs.DirEntry, err error) error，别和老版参数顺序搞混
遍历中修改目录结构容易 panic 或遗漏
在 filepath.WalkDir 回调里删文件、重命名目录、甚至创建同级子目录，都可能导致后续遍历行为异常——比如 os.Remove 一个正在遍历的子目录，下一层 ReadDir 可能返回 io.EOF 或 syscall.ENOENT，而你没捕获就 panic。
更隐蔽的问题是：在遍历中途 os.MkdirAll 一个已存在但尚未走到的路径，不会影响当前 walk 流程；但若新建的是父目录的兄弟目录，walk 完全感知不到。
- 安全做法是「两阶段」：第一遍只收集路径，第二遍再批量操作
- 如果必须边走边删，务必检查
err是否为os.ErrNotExist或syscall.ENOTDIR等可忽略错误 - 避免在回调中调用
os.Chdir，会干扰filepath内部路径拼接逻辑
filepath.Join 处理空字符串和绝对路径要小心
很多人以为 filepath.Join("a", "", "b") 得到 "a/b"，其实结果是 "a/b"（空字符串被忽略）；但一旦其中任意一段是绝对路径（如 "C: oo" 或 "/home"），前面所有路径都会被丢弃——filepath.Join("a", "/tmp", "b") 结果就是 "/tmp/b"。
这在拼接用户输入路径时极易出错。比如你从配置读到 base = "data"，又拿到一个相对路径 "log/2024/06"，用 filepath.Join(base, input) 没问题；但如果用户误填了 input = "/tmp/out"，结果就变成 "/tmp/out"，完全脱离预期根目录。
- 对不可信输入，先用
filepath.IsAbs(input)检查，不符合预期就拒绝或报错 - 想强制限定在某目录下？用
filepath.Rel(root, absPath)配合filepath.Join做白名单校验 - Windows 下注意
filepath.Join("C:", "foo")得到"C:foo"（缺反斜杠），应写成filepath.Join("C:\", "foo")或用filepath.Clean
跨平台路径分隔符不能靠字符串切割
有人用 strings.Split(path, "/") 拆路径，这在 Windows 上跑 filepath.Join("C:\a", "b") 得到 "C:\a\b"，再切就出错。还有人用 path[0] == '/' 判断绝对路径，Linux 成立，Windows 下 "C:\foo" 就失效。
根本原因是 filepath 包内部根据 GOOS 自动切换分隔符（filepath.Separator 是 '\' 或 '/'），所有路径操作必须走它的 API。
- 取文件名用
filepath.Base(path)，不是strings.LastIndex - 取目录名用
filepath.Dir(path)，不是strings.TrimSuffix - 判断是否为根目录用
filepath.IsAbs(path) && filepath.Dir(path) == path，而不是硬写path == "/"
真正麻烦的不是 API 不好找，而是错误路径逻辑在本地开发时恰好“碰巧”跑通，一上 CI 或换系统就崩。多花十秒用 filepath 原生函数，比后期 debug 跨平台路径 bug 省半天。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
