本文深入探讨了如何使用 Python 的 pathlib 模块高效、安全地递归遍历目录并精准排除特定子目录（如 node_modules、temp、venv 等），既剖析了常见误区（如误用 glob 模式“否定”路径），也提供了面向不同 Python 版本的实用方案：对旧版本推荐基于 `Path.rglob()` 配合 `path.parts` 的简洁过滤与 `safe_rglob` 封装，兼顾跨平台路径处理、set 快速查找及符号链接与权限异常防护；对 Python 3.12+ 则重点介绍原生 `Path.walk()` 的原地修改 `dirs[:]` 能力，实现真正跳过、避免冗余遍历的高性能控制——无论你面临嵌套深层的排除需求、复杂文件系统环境，还是追求生产级健壮性，这里都有清晰、可靠且可直接落地的解决方案。

用 pathlib.Path.rglob 配合条件过滤跳过指定子目录

rglob 本身不支持排除路径，必须手动过滤。常见错误是试图用 ** glob 模式直接“否定”某个目录名——这在 pathlib 中不可行，模式只支持匹配，不支持排除。

正确做法是遍历全部，再用 parent 或 parts 判断路径是否落在要排除的目录下：

• 检查 path.parent.name == "node_modules" 只能跳过一级子目录，漏掉 src/node_modules/utils 这类嵌套路径
• 更可靠的是用 path.parts 遍历每一级目录名，或用 str(path).startswith() 做前缀判断（注意跨平台路径分隔符）
• 推荐用 any(part == "node_modules" for part in path.parts)，简洁且覆盖所有层级

用 pathlib.Path.walk（Python 3.12+）精准控制遍历行为

Python 3.12 引入的 walk 方法允许在进入子目录前修改 dirs 列表，实现真正意义上的“跳过”，避免无谓遍历：

for root, dirs, files in Path("project").walk():
    # 在这里修改 dirs 列表，原地移除要跳过的目录名
    dirs[:] = [d for d in dirs if d != "venv" and d != "__pycache__"]
    for file in files:
        print(root / file)

注意：dirs[:] 是关键，必须原地修改；直接赋值 dirs = [...] 无效。该方法比 rglob + 过滤更高效，尤其面对大量无关子目录时。

兼容旧版本 Python 的安全排除写法

若仍在用 Python < 3.12，可用 os.walk 模拟相同逻辑，或封装一个带排除的 rglob 辅助函数：

def safe_rglob(root: Path, pattern: str = "*", exclude_dirs: set = None):
    if exclude_dirs is None:
        exclude_dirs = {"node_modules", ".git", "dist"}
    for p in root.rglob(pattern):
        if not any(part in exclude_dirs for part in p.parts):
            yield p
使用
for pyfile in safe_rglob(Path("."), "*.py"):
print(pyfile)

这个函数的关键点在于：排除判断放在 yield 前，且作用于每个 p 而非仅顶层；exclude_dirs 用 set 保证 O(1) 查找；p.parts 自动处理不同系统的路径分隔符。

容易被忽略的符号链接与权限问题

默认情况下，rglob 和 walk 都会跟随符号链接，可能意外进入不该访问的路径，甚至触发循环引用。如果目标目录含软链，务必加判断：

• 用 p.is_symlink() 提前跳过，或
• 在 walk 中检查 root / d 是否为符号链接再决定是否保留到 dirs
• 遇到 PermissionError（如 /proc 下某些目录），需用 try/except 包裹，否则遍历中断

实际项目中，排除逻辑常和权限、符号链接、挂载点混在一起，光靠目录名过滤远远不够。

今天关于《使用 pathlib 递归遍历目录并排除特定子目录，可以通过 Path.glob() 或 Path.rglob() 结合生成器表达式或列表推导来实现。以下是一个示例代码，展示如何排除指定的子目录：from pathlib import Path def traverse_directory(root_dir, exclude_dirs): root = Path(root_dir) for item in root.rglob('*'): # 检查路径中是否包含被排除的目录 if any(exclude in item.parts for exclude in exclude_dirs): continue print(item) # 示例用法 traverse_directory('.', ['temp', 'backup'])说明：root.rglob('*')：递归遍历所有文件和子目录。item.parts：将路径拆分为各个部分（如 ['.', 'folder1', 'subfolder', 'file.txt']）。exclude_dirs：需要排除的子目录名称列表。优化版（支持多层排除）：如果希望更精确地排除某个子目录（例如 exclude_dirs = ['temp'] 会排除所有名为 temp 的子目录），可以进一步检查路径是否以排除目录结尾： def traverse_directory(root_dir, exclude_dirs): root = Path(root_dir) for item in root.rglob('*'): if any(item.match(f'**/{exclude》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！