filepath.WalkDir比filepath.Walk更稳定，Go 1.16+推荐使用，因其基于fs.DirEntry避免冗余stat调用、权限错误可显式处理、支持filepath.SkipDir精准跳过子目录，且不默认跟随符号链接。
用 filepath.WalkDir 遍历目录比 filepath.Walk 更稳
Go 1.16+ 推荐用 filepath.WalkDir，它默认使用 DirEntry（不触发 Stat），性能更好、权限错误更可控。旧版 filepath.Walk 在遇到无读权限子目录时容易 panic 或静默跳过，而 WalkDir 允许你显式判断并决定是否继续。
关键点：
-
WalkDir的回调函数接收fs.DirEntry，调用entry.IsDir()即可判断类型，无需额外os.Stat - 若回调返回非 nil error（如
filepath.SkipDir），WalkDir 会跳过该目录及其子项 - 对根路径本身也要做一次
os.Stat检查，确保它是目录，否则直接报错退出
打印缩进树形结构的关键是维护深度和分支标记
树形输出不是靠递归函数栈深度自动推导，而是靠传入当前层级（depth）和一个布尔切片（记录每层是否为“最后一个子项”），再拼接 ├──、└──、│ 这类符号。很多人直接用 tab 或空格硬缩进，结果无法对齐分支线。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
[]bool记录路径上每一级是否是其父目录的最后一个条目，例如[true, false, true]表示第 0 层是最后一个、第 1 层不是、第 2 层是 - 每行开头按 depth 循环拼接：若
i < depth-1，加│；若i == depth-1，末尾是true就用└──，否则用├── - 文件名前缀长度 = depth × 4，但符号逻辑必须独立计算，不能只靠字符串重复
处理 symlink 和 permission denied 要主动拦截
默认 WalkDir 遇到 symlink 会跟随（可能造成循环或越界），遇到 permission denied 会把 error 传给回调函数——但如果你没检查就 return，整个遍历就停了。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
常见错误现象：open /root: permission denied 导致程序提前退出，或者遍历突然中断在某个子目录。
应这样处理：
- 在回调中用
errors.Is(err, fs.ErrPermission)判断权限错误，打印警告后返回nil继续遍历其他路径 - 用
entry.Type() & fs.ModeSymlink != 0识别 symlink；若不希望展开，直接return filepath.SkipDir（对 symlink 目录）或忽略（对 symlink 文件） - 避免用
os.Readlink做额外解析——展示树形结构不需要目标路径，除非明确要求标注@> target
命令行参数解析建议用 flag + 简单校验，别过早引入 cobra
工具类小命令，不需要完整 CLI 框架。用标准库 flag 就够，重点是加一层输入防护。
容易踩的坑：
- 用户执行
tree ./nonexist，WalkDir不会报错，但回调根本不会被调用——必须在WalkDir前用os.Stat检查路径是否存在且为目录 -
flag.String默认值设为空字符串，但用户不传参数时应默认为"."，而不是让WalkDir("", ...)崩溃 - 支持
-a显示隐藏文件？那就得在回调里判断strings.HasPrefix(entry.Name(), ".")，并跳过（除非开了 flag）
复杂点其实不在遍历逻辑，而在如何让输出既符合终端直觉（比如不因长文件名折行错位），又能在不同文件系统权限下稳定跑完——这些细节不写进 error handling 和 prefix 构建里，工具就只是个玩具。
