Python os.walk用法及代码示例

用法: os.walk(top, topdown=True, onerror=None, followlinks=False)

通过自上而下或自下而上遍历树，在目录树中生成文件名。对于以目录 top 为根的树中的每个目录(包括 top 本身)，它会产生一个三元组 (dirpath, dirnames, filenames) 。

dirpath 是一个字符串，是目录的路径。 dirnames 是 dirpath 中子目录的名称列表(不包括 '.' 和 '..' )。 filenames 是 dirpath 中非目录文件的名称列表。请注意，列表中的名称不包含路径组件。要获取 dirpath 中文件或目录的完整路径(以 top 开头)，请执行 os.path.join(dirpath, name) 。列表是否排序取决于文件系统。如果在生成列表期间从dirpath 目录中删除或添加文件，则未指定是否包含该文件的名称。

如果可选参数 topdown 是 True 或未指定，则在其任何子目录的三元组之前生成目录的三元组(目录是自上而下生成的)。如果 topdown 是 False ，则在其所有子目录的三元组之后生成目录的三元组(目录自下而上生成)。无论topdown 的值如何，都会在生成目录及其子目录的元组之前检索子目录列表。

当 topdown 为 True 时，调用者可以就地修改 dirnames 列表(可能使用 del 或切片赋值)，并且 walk() 只会递归到名称保留在 dirnames 中的子目录；这可用于修剪搜索，强制执行特定的访问顺序，甚至在调用者再次恢复 walk() 之前通知 walk() 有关调用者创建或重命名的目录。当topdown 为False 时修改dirnames 对walk 的行为没有影响，因为在自底向上模式下，dirnames 中的目录是在dirpath 本身生成之前生成的。

默认情况下，来自 scandir() 调用的错误将被忽略。如果指定了可选参数onerror，它应该是一个函数；它将使用一个参数调用，即 OSError 实例。它可以报告错误以继续遍历，或引发异常以中止遍历。请注意，文件名可用作异常对象的filename 属性。

默认情况下，walk() 不会进入解析为目录的符号链接。将 followlinks 设置为 True 以访问支持符号链接的系统上的目录。

注意

请注意，如果链接指向其自身的父目录，则将 followlinks 设置为 True 可能会导致无限递归。 walk() 不跟踪它已经访问过的目录。

注意

如果您传递相对路径名，请不要在 walk() 的恢复之间更改当前工作目录。 walk() 永远不会更改当前目录，并假定其调用者也不会。

这个例子显示了起始目录下每个目录中非目录文件占用的字节数，除了它不在任何 CVS 子目录下查找：

import os
from os.path import join, getsize
for root, dirs, files in os.walk('python/Lib/email'):
    print(root, "consumes", end=" ")
    print(sum(getsize(join(root, name)) for name in files), end=" ")
    print("bytes in", len(files), "non-directory files")
    if 'CVS' in dirs:
        dirs.remove('CVS')  # don't visit CVS directories

在下一个示例中(shutil.rmtree() 的简单实现)，自下而上遍历树是必不可少的，rmdir() 不允许在目录为空之前删除目录：

# Delete everything reachable from the directory named in "top",
# assuming there are no symbolic links.
# CAUTION:  This is dangerous!  For example, if top == '/', it
# could delete all your disk files.
import os
for root, dirs, files in os.walk(top, topdown=False):
    for name in files:
        os.remove(os.path.join(root, name))
    for name in dirs:
        os.rmdir(os.path.join(root, name))

使用参数 top 、 topdown 、 onerror 、 followlinks 引发审计事件 os.walk 。

在 3.5 版中更改：这个函数现在调用os.scandir代替os.listdir()，通过减少对os.stat.

在 3.6 版中更改：接受一个path-like 对象.

相关用法

注：本文由纯净天空筛选整理自python.org大神的英文原创作品 os.walk。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。