Python自定义递归函数打印目录树结构

本文深入探讨了如何用Python自定义递归函数优雅地打印带层级缩进和标准树形符号（如“├──”“└──”）的目录结构，直击os.walk输出扁平、缺乏视觉层次的痛点；通过手动遍历+enumerate动态判断末尾项来精准控制符号选择，强调缩进字符串逐层传递、中英文路径兼容（尤其解决Windows下中文UnicodeEncodeError）、避免硬拼路径及索引陷阱等实战细节，并理性对比pathlib.rglob与第三方库的适用边界，最终回归简洁可靠的手写递归本质——既提升代码可读性与可控性，又规避过度工程化。

用 os.walk 打印树状结构太扁平，怎么改？

os.walk 默认按深度优先遍历，但只返回三层元组（根、子目录列表、文件列表），不带层级信息。直接打印会丢失缩进逻辑，看起来像平铺列表而非树。

实操建议：

• 用递归函数封装 os.walk 的结果，或更干脆——绕开它，改用 os.listdir + os.path.isdir 手动控制层级
• 每层递归传入当前缩进字符串（如 "│ " 或 "├── "），避免全局状态干扰
• 注意：Windows 路径分隔符是 \，但 os.path.join 和 pathlib.Path 会自动适配，别硬拼字符串

递归函数里怎么判断该画“├──”还是“└──”？

树形符号的差异只取决于“当前项是不是父目录下最后一个子项”，和深度无关。靠循环时是否到达列表末尾来决定符号，不是靠计数器或索引比大小。

实操建议：

• 对子项列表用 enumerate，检查 i == len(items) - 1
• 不要用 range(len(...)) 再去取元素，容易索引错位
• 符号前缀要和缩进对齐：上层用 "│ "，当前层末尾用 "└── "，非末尾用 "├── "
• 示例片段：

  for i, name in enumerate(entries):<br>    prefix = "└── " if i == len(entries) - 1 else "├── "<br>    print(indent + prefix + name)

中文路径报 UnicodeEncodeError 怎么办？

常见于 Windows 控制台默认编码是 gbk，而 Python 3 字符串是 Unicode，print 时尝试用 gbk 编码输出含中文的字符串就崩了。

实操建议：

• 运行脚本时加 python -X utf8 script.py 强制启用 UTF-8 模式（Python 3.7+）
• 或在脚本开头加 import sys; sys.stdout.reconfigure(encoding='utf-8')（Python 3.7+）
• 不推荐用 chcp 65001 临时切控制台编码，不稳定且影响其他程序
• 如果必须兼容旧环境，可对输出做 .encode('gbk', errors='replace').decode('gbk')，但会丢字，慎用

pathlib.Path.rglob 能不能直接替代手写递归？

能列全路径，但没法天然带层级关系和树形符号——它返回的是无序的生成器，连父子关系都要靠 .parent 反推，反而更绕。

实操建议：

• 别为了“用新语法”硬套 rglob；树状打印本质是结构化遍历，pathlib 适合路径操作，不擅长控制输出形态
• 若坚持用 pathlib，得先收集所有路径 → 按 .parts 分段 → 按深度分组 → 手动补缩进，代码量不减反增
• 真正省事的做法：用第三方库 tree（命令行）或 anytree（Python 库），但引入依赖前先问自己——就打个目录树，值得吗？

实际写的时候，最容易被忽略的是符号与缩进的对应关系：比如第二层用了 "│ "，第三层却忘了在子项前加这个前缀，整棵树就歪了。还有就是把 os.scandir 当成 os.listdir 用，忘了它返回的是 DirEntry 对象，得调 .name 和 .is_dir()，直接用字符串比较会出错。

今天关于《Python自定义递归函数打印目录树结构》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！