如何无需克隆即可在Hugging Face仓库中搜索特定文件名？

直接搜索特定文件名（高效方式） #

使用HfFileSystem的glob方法可以直接匹配仓库中的文件路径，无需先拉取全部文件列表，适合大仓库场景：

from huggingface_hub import HfFileSystem

# 初始化Hugging Face文件系统
fs = HfFileSystem()

# 搜索目标文件名，支持通配符：** 匹配任意子目录
# 替换为你的仓库ID和目标文件名，例如 "bert-base-uncased/**/config.json"
matching_files = fs.glob("your-repo-id/**/target-filename.ext")

# 打印匹配结果
print(matching_files)

获取完整文件列表后过滤 #

如果需要先拿到仓库所有文件再筛选，用list_repo_files函数：

from huggingface_hub import list_repo_files

# 获取指定仓库的所有文件路径
all_files = list_repo_files(repo_id="your-repo-id")

# 过滤出包含目标文件名的路径
target_files = [file_path for file_path in all_files if "target-filename.ext" in file_path]

print(target_files)

注意事项 #

• 若仓库是私有仓库，需先通过huggingface_hub.login()完成登录，或设置HF_TOKEN环境变量。
• glob方法的路径格式必须以仓库ID开头，**用于递归匹配所有子目录，避免漏查深层文件。

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