Python pathlib glob 找不到隐藏文件时怎么处理

用 Python 扫描配置目录时，Path.glob("*.json") 明明写得没问题，却常被误认为“找不到隐藏文件”。先记住一个容易混淆的结论：pathlib.Path.glob() 和 glob.glob() 不是同一套默认规则。前者不会把点号开头的文件当成特殊对象，后者默认会跳过它们。

pathlib 的 glob 为什么能匹配点号文件

在 Unix 风格命名里，.env、.gitignore 和 .config.json 通常被称为隐藏文件。对 Path.glob() 来说，点号只是文件名的一部分，* 仍然可以匹配它。它的结果是 Path 对象，而且返回顺序没有保证；需要稳定输出时要自己调用 sorted()。

from pathlib import Path

root = Path("project")
# pathlib 不把点号当作隐藏匹配开关，* 可以覆盖文件名主体
json_files = sorted(root.glob("*.json"))

for path in json_files:
    # 只处理普通文件，避免把同名目录当成输入
    if path.is_file():
        print(path)

如果你把同一需求改成标准库 glob 模块，默认结果就不同。官方文档明确说明，通配符默认不能匹配以点号开头的路径段；可以写成 glob.glob(".*.json")，也可以在 Python 3.11 及以上开启 include_hidden=True。

import glob

# Python 3.11+：让通配符也覆盖点号开头的路径段
paths = glob.glob("project/**/*.json", recursive=True, include_hidden=True)
for name in sorted(paths):
    print(name)

递归匹配时，先确认你要的是文件还是整棵目录树

Path.rglob("*.json") 相当于从当前路径递归寻找匹配项，隐藏目录不会因为名字以点号开头就自动消失。它适合备份、索引或配置收集，但大目录树可能扫描很久，返回顺序也不应直接拿来做业务排序。

因此，先把“匹配到什么”与“后续怎么处理”分开：glob 负责找候选，is_file() 负责确认类型，sorted() 负责稳定顺序。这样即使目录里同时出现 .cache 目录和普通 JSON 文件，代码意图也清楚。

需要排除隐藏目录时，过滤要放在哪里

如果需求是“只收集用户目录下的可见 JSON 文件”，不要把希望寄托在 Path.rglob() 的默认行为上。先得到相对路径，再检查每一个路径段是否以点号开头；这样不仅能排除 .cache/data.json，也能排除普通目录下的 reports/.draft.json。

from pathlib import Path
from collections.abc import Iterator

def visible_files(root: Path, pattern: str) -> Iterator[Path]:
    # rglob 先覆盖所有候选路径，是否隐藏由业务规则决定
    for path in root.rglob(pattern):
        relative = path.relative_to(root)
        # 任一层目录或文件名以点号开头，就视为隐藏路径
        if any(part.startswith(".") for part in relative.parts):
            continue
        # 只把普通文件交给后续读取逻辑
        if path.is_file():
            yield path

for path in sorted(visible_files(Path("project"), "*.json")):
    print(path)

按扫描目标选择写法，避免把两个 glob 混为一谈

还要区分“点号命名”和“操作系统的隐藏属性”。本文讨论的是前者；如果文件名本身没有点号，只是在文件管理器里被标记为隐藏，glob 仍然主要依据路径名匹配。正式接入前，可先打印候选路径、确认模式是否覆盖目标后，再决定是否过滤。

规则可在 Python pathlib 官方文档和 glob 官方文档中复核；尤其注意 Python 版本对 include_hidden 和其他关键字参数的支持差异。

相关问题

Path.glob("*") 会返回隐藏目录吗？

会。pathlib 不把点号开头目录自动排除；是否递归、是否保留它们，需要由模式和业务过滤共同决定。

为什么 glob.glob("*") 找不到 .env？

这是 glob 模块的默认规则。可以用以点号开头的模式，或在 Python 3.11 及以上传入 include_hidden=True。

Path.rglob 的结果需要排序吗？

如果结果要用于生成清单、比较差异或稳定测试，就应该显式排序；官方文档不保证返回顺序。