filepath.walk需手动防符号链接循环和深度过深：用闭包限深度（如>32层返回skipdir），遇symlink时通过evalsymlinks+inode哈希去重，权限错误返回nil继续，路径输出用%q转义防乱码。
用 filepath.Walk 遍历目录但避免递归过深或符号链接循环
Go 标准库的 filepath.Walk 是最直接的选择，但它默认不检测符号链接循环，且对超深嵌套（如恶意构造的 1000 层子目录）不做限制。实际使用中容易卡死或触发栈溢出。
- 务必在
WalkFunc中检查os.FileInfo.IsDir()和os.FileInfo.Mode()&os.ModeSymlink != 0，遇到符号链接时记录已访问路径哈希（如absPath + fileInfo.Sys().(*syscall.Stat_t).Ino），重复则跳过 - 用闭包变量计数当前深度，超过阈值（如 32）直接返回
filepath.SkipDir - 不要依赖
filepath.Walk的默认行为——它不会自动 resolve 符号链接，os.Lstat返回的是链接本身，不是目标；需手动调用filepath.EvalSymlinks判断是否已访问过目标
生成树形结构时避免用嵌套 map 或 struct 做动态建模
常见写法是定义 type DirNode struct { Name string; Children []DirNode } 然后递归填充，但这会导致大量内存分配和 GC 压力，尤其在数千节点时明显拖慢解析速度。
- 改用扁平化 slice + 父子索引：一次遍历收集所有节点（含绝对路径、深度、是否为目录），再用栈维护当前路径层级，通过
parentIndex字段构建逻辑父子关系 - 如果只需输出文本树（如类似
tree命令），直接边遍历边格式化输出，完全跳过中间结构体——用strings.Repeat("│ ", depth) + "├── " + name拼接，性能提升显著 - 若需支持过滤（如忽略
.git）、排序或后续查询，用map[string]*Node按路径做 key，比嵌套结构更易增删查
处理中文路径、特殊字符和权限拒绝错误
Windows 下中文路径、Linux 下带 emoji 或 control 字符的文件名，在 fmt.Println 或日志中常显示为 ??? 或 panic；而 permission denied 错误若不显式处理，filepath.Walk 会直接终止整个遍历。
- 所有路径输出统一用
fmt.Sprintf("%q", path)，确保不可见字符被转义，避免终端渲染异常 - 在
WalkFunc中判断err != nil后，用errors.Is(err, os.ErrPermission)区分权限错误和其他错误；前者返回nil继续遍历，后者才中断 - Windows 上注意
filepath.Separator是'\'，但 Go 多数 API 接受正斜杠；保持路径内部统一用/（filepath.ToSlash转换），避免混用导致匹配失败
导出为 JSON 或支持流式输出时别用 json.MarshalIndent 一次性序列化
当目录节点超 10 万时，json.MarshalIndent 会申请巨大临时内存并阻塞 goroutine，且无法增量响应——前端或 CLI 工具需要“边扫边吐”时完全不适用。
- 用
json.NewEncoder(os.Stdout).Encode(node)对每个节点单独编码，配合chan *Node实现生产者-消费者模式 - JSON 输出前先调用
json.Compact去除空格，减少体积；若需 human-readable，只对前 100 个节点做MarshalIndent，其余保持紧凑格式 - 注意
os.FileInfo.ModTime()在 JSON 中会变成浮点秒时间戳，丢失纳秒精度；如需保留，提前转成 ISO8601 字符串字段
真正难的不是遍历本身，而是怎么在不出错的前提下，让模块能跑在 CI 的容器里、能处理用户 U 盘里的乱码文件名、能被另一个 Go 程序安全 import 而不引发 panic——这些边界情况比树形算法本身更消耗调试时间。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
