优先用filepath.walkdir（go 1.16+），通过strings.count(path, string(filepath.separator))计算层级，配合fs.direntry避免重复stat；用io.writestring高效拼接树形前缀，手动管理缩进与连接符，并用私有error控制--max-depth中断。
如何用 filepath.WalkDir 遍历目录并保留层级关系
直接用 filepath.Walk 很容易丢失目录深度信息，导致树形缩进错乱；filepath.WalkDir（Go 1.16+）返回 fs.DirEntry，能通过路径分割快速算出层级，且避免重复 stat。
- 每次回调时，用
strings.Count(path, string(filepath.Separator))算当前深度（注意：Windows 路径分隔符是'\'，统一用filepath.Separator） - 不要在遍历中调用
os.Stat——DirEntry的IsDir()和Type()已足够判断类型 - 遇到 symlink 时，默认不递归（除非显式启用），否则可能陷入循环或权限错误
io.WriteString 拼接树形前缀比字符串格式化更高效
拼接每行的缩进前缀（如 ├──、│ 、└──）时，频繁用 fmt.Sprintf 生成重复空格会分配大量小对象；io.WriteString 直接写入 bufio.Writer 更轻量。
- 预先构建好每层的前缀字符串（例如
prefix := strings.Repeat("│ ", depth-1) + "├── "），再用io.WriteString(w, prefix) - 对最后一项子节点，把
"├── "换成"└── "，其父级后续所有兄弟项的竖线（│）要截断——需缓存上一层是否为“末尾项” - 别用
fmt.Fprintln写每行——它内部会额外加锁和格式解析，纯文本输出用w.Write或io.WriteString即可
处理中文路径和特殊字符时必须用 os.Stdout 原始写入
Windows 控制台或某些终端对 UTF-8 输出有编码限制，fmt.Println 可能触发 ??? 替换或 panic；绕过格式化器直接写原始字节更可靠。
- 用
os.Stdout.Write([]byte(line + " "))，而非fmt.Println(line) - 确保源码文件保存为 UTF-8 无 BOM；Go 编译器本身不干预字符串编码，但终端能否显示取决于系统 locale 和字体
- 若需兼容旧版 Windows cmd（非 PowerShell / WSL），可在启动时加
os.Setenv("GODEBUG", "godebug=1")并检查os.Stdout.Fd()是否为控制台句柄（非必需，仅调试用）
如何让工具支持 --max-depth 且不破坏遍历逻辑
filepath.WalkDir 不提供中断机制，靠返回非 nil error 退出；但不能随便 return errors.New("stop")，否则上层无法区分是用户中断还是真实错误。
- 定义一个私有 error：
var errMaxDepth = fmt.Errorf("max depth reached")，并在深度超限时返回它 - 在 WalkDir 回调中，检测当前深度 ≥
maxDepth且是目录时，返回errMaxDepth；注意：仍需输出该层目录名（否则用户看不到截止位置） - 主函数中用
errors.Is(err, errMaxDepth)判断是否为预期中断，不打印堆栈，也不 exit(1)
树形结构的难点不在遍历，而在状态同步——每一行的连接符依赖父级是否还有兄弟、当前是否末尾，这些信息没法只靠路径推导，得边走边记。没缓存好“上一项是不是最后一个”，画出来的树就容易断连或错位。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
