首页 > 文章 > python教程

Python pathlib.Path.glob 递归匹配隐藏目录怎么处理

来源：17golang原创

时间：2026-09-10 13:38:30 207浏览收藏

用 pathlib.Path.glob() 递归查找文件时，隐藏目录是否能匹配，关键不在于额外打开一个“显示隐藏文件”开关，而在于 pathlib 和 glob 模块的规则不同：Path.glob("**/*.py") 会进入普通目录和点号开头的隐藏目录。若目标是排除 .git、缓存或构建目录，就要在结果中检查路径组件，或者在遍历目录时提前裁剪。

官方文档：https://docs.python.org/3/library/pathlib.html

要点速览

pathlib 不把点号开头的路径当作特殊项，** 会递归匹配到隐藏目录。
只想包含隐藏目录时直接使用 glob 或 rglob；想排除时检查相对路径的每个组件。
目录树很大时，用 Path.walk() 从 dirnames 中移除隐藏目录，减少后续扫描。

Path.glob 为什么会匹配到隐藏目录

Path.glob() 接收相对模式，** 表示任意层级的文件或目录组件。pathlib 的点号文件名没有特殊排除语义，所以 .cache、.git 这样的目录和 src 一样会参与匹配。Path.rglob("*.py") 可以理解为在模式前加上 **/。

Python pathlib Path.glob 使用 ** 递归匹配普通目录与隐藏目录中的 Python 文件 — 图1：pathlib 的 `**` 递归会进入普通目录和隐藏目录；点号开头的路径不会被自动排除。

因此下面的代码会把隐藏目录中的 Python 文件也纳入结果：

from pathlib import Path

root = Path("project")
# ** 会递归进入每一层目录，pathlib 不会自动排除点号目录
matches = list(root.glob("**/*.py"))

# glob 返回顺序不固定；需要稳定输出时显式排序
for path in sorted(matches):
    print(path)

如果你只是希望“递归查找所有 Python 文件”，这已经是正确写法；不要为了匹配隐藏目录再拼接一个 .* 模式。只有需要排除隐藏目录时，才需要增加过滤逻辑。

包含隐藏目录和排除隐藏目录，写法不是一回事

包含隐藏目录的规则很简单：使用 root.glob("**/*.py") 或 root.rglob("*.py")。排除时不能只判断文件名，因为普通目录下的文件可能位于隐藏目录的更深层；应该检查相对于根目录的每一个路径组件。

from pathlib import Path

def is_hidden_component(name: str) -> bool:
    # 单独处理当前目录标记，避免把空名称当成隐藏项
    return bool(name) and name.startswith(".") and name not in {".", ".."}

root = Path("project")
visible_python_files = []
for path in root.rglob("*.py"):
    relative_parts = path.relative_to(root).parts
    # 任意一层是隐藏目录或隐藏文件，就不纳入公开文件集
    if any(is_hidden_component(part) for part in relative_parts):
        continue
    visible_python_files.append(path)

for path in sorted(visible_python_files):
    print(path)

目标	建议写法	注意点
包含隐藏目录中的文件	`root.rglob("*.py")`	点号路径不会自动排除
排除所有隐藏路径	遍历结果并检查每个 `relative_to(root).parts`	不要只检查最后一个文件名
只找隐藏目录中的文件	保留包含点号组件的结果	明确是否把隐藏文件本身也算入

要排除隐藏目录时，先过滤还是先裁剪

目录规模不大时，“先 glob、后过滤”最直观，也便于复用 rglob 的匹配模式。若目录树很深，仍然遍历了 .git 或缓存目录，就会产生不必要的扫描。Python 3.12 及更高版本可以考虑 Path.walk()，在继续进入子目录前修改 dirnames。

Python Path.walk 通过 dirnames 裁剪隐藏目录与 glob 结果过滤的对比关系图 — 图2：结果集过滤适合小范围查找；需要减少深层扫描时，可在 `Path.walk()` 的目录列表中裁剪隐藏目录。

from pathlib import Path

root = Path("project")
for directory, dirnames, filenames in root.walk():
    # top_down=True 时修改 dirnames，就能阻止后续进入隐藏目录
    dirnames[:] = [name for name in dirnames if not name.startswith(".")]
    for filename in filenames:
        if filename.endswith(".py") and not filename.startswith("."):
            print(directory / filename)

这个方案的重点是“裁剪目录”，而不是把隐藏目录访问后再丢弃。它适合明确不需要扫描隐藏目录的项目文件、源码或导入目录。若还要跟随符号链接、处理权限错误或跨 Python 版本运行，应把这些条件写进脚本说明，不能仅凭输出为空就判断目录不存在。