如何通过Python os.walk按层级逻辑顺序输出规范目录树

问题原因 #

你当前的代码有两个逻辑问题，导致输出顺序不符合预期：

1. 遍历过程中没有将当前迭代到的root路径本身加入结果列表，直接缺失了最顶层的根路径，且子文件夹路径提前在父级迭代阶段被追加，打乱了层级顺序。
2. 追加同层路径时先处理子文件夹、后处理直属文件，导致同层级的文件夹全部排在文件前面，不符合同层先列直属文件、再展开子文件夹内容的阅读顺序。

修正方案 #

利用os.walk的topdown=True遍历特性（先返回父级目录，再依次递归遍历子目录），调整追加逻辑即可，不需要额外做复杂排序：

1. 每轮迭代首先将当前目录路径root加入结果列表，保证目录本身出现在其内部内容之前。
2. 紧接着追加当前目录下的所有直属文件，保证同层文件排在子文件夹前面。
3. 对dirs和files列表原地排序，避免不同文件系统返回的文件顺序不一致，保证输出按名称升序排列。

修正后的代码如下：

import os

tree = []
target_path = r'C:\test'
for root, dirs, files in os.walk(target_path, topdown=True):
    # 加入当前目录自身
    tree.append(root)
    # 对当前层文件按名称排序，保证顺序稳定
    files.sort()
    # 加入当前目录下所有直属文件
    for f in files:
        tree.append(os.path.join(root, f))
    # 对子文件夹按名称排序，控制后续递归遍历的顺序
    dirs.sort()

for path in tree:
    print(path)

运行上述代码的输出完全匹配你需要的顺序：

C:\test
C:\test\test1.txt
C:\test\subfolder1
C:\test\subfolder1\file1.txt
C:\test\subfolder1\file2.txt
C:\test\subfolder2
C:\test\subfolder2\file3.txt

如果需要实现举例的缩进展示效果，只需要在打印时根据路径深度计算缩进量即可，比如统计当前路径和根路径的路径分隔符数量差值，每多一级就多缩进4个空格。

内容的提问来源于stack exchange，提问作者user14380579