本文介绍如何在已知文件名但未知扩展名的情况下，高效定位目标文件（如用户头像图片），利用 glob 模块实现简洁、可靠且性能良好的匹配方案。
本文介绍如何在已知文件名但未知扩展名的情况下，高效定位目标文件（如用户头像图片），利用 glob 模块实现简洁、可靠且性能良好的匹配方案。
在实际开发中，尤其是处理用户上传资源（如头像、证件照）时，常采用“用户 ID 作为文件名 + 可变扩展名”的命名策略（例如 123.png、123.jpg、456.webp）。此时若仅持有用户 ID（即无扩展名的纯名称），又需精准获取对应文件路径，传统做法是遍历整个目录并逐个比对 os.path.splitext() 的基础名——这不仅代码冗长，且在文件量较大时性能堪忧。
幸运的是，Python 标准库中的 glob 模块提供了轻量高效的通配符匹配能力，完美适配该场景。其核心思路是：*将文件名与通配符 . 组合，交由操作系统级的文件系统接口进行模式扫描**。虽然底层仍涉及目录遍历，但 glob.glob() 经过高度优化（C 层实现、路径缓存、系统调用批处理等），远快于纯 Python 的手动循环。
以下为推荐实现：
import glob
import os
def find_file_by_name(directory: str, basename: str) -> str | None:
"""
根据无扩展名的文件名，在指定目录中查找首个匹配文件。
假设同名文件至多存在一个（符合业务约束）。
"""
pattern = os.path.join(directory, f"{basename}.*")
matches = glob.glob(pattern)
# 返回第一个匹配项（按文件系统顺序，通常可接受）
return matches[0] if matches else None
# 使用示例
user_id = "123"
image_dir = "/var/www/assets/avatars"
target_path = find_file_by_name(image_dir, user_id)
if target_path:
print(f"Found: {target_path}")
# → e.g., "/var/www/assets/avatars/123.png"
else:
print("File not found.")✅ 优势说明：
Python Matplotlib Chinese Font
下载
使用 font_manager.addfont() 添加中文字体文件，设置 rcParams['font.family']，并禁用 unicode_minus，使 matplotlib 显示中文。
立即学习“Python免费学习笔记（深入）”；
- 简洁性：单行模式即可覆盖所有扩展名，无需硬编码 .png, .jpg 等；
- 健壮性：自动兼容任意合法扩展名（含多级后缀如 .tar.gz）；
- 性能可控：在千级文件规模下毫秒级响应；若目录长期稳定，还可进一步预构建 {basename → full_path} 字典缓存，实现 O(1) 查找。
⚠️ 注意事项：
- glob 不支持正则语法，仅支持 *、?、[abc] 等 shell 风格通配符；
- 若需跨平台路径安全，请始终使用 os.path.join() 或 pathlib.Path 构造 pattern；
- 当严格要求“唯一匹配”时，建议增加校验逻辑（如 if len(matches) > 1: raise ValueError(...)），避免隐式取首个带来的歧义；
- 对于超大规模（>10 万文件）或高并发场景，应考虑升级为 SQLite 轻量索引（建表 CREATE TABLE files (name TEXT PRIMARY KEY, path TEXT)），将查找降至微秒级。
综上，glob.glob("dir/name.*") 是兼顾可读性、性能与标准库依赖的最优解——无需第三方包，不牺牲可靠性，一行代码解决“有名字、没后缀”的经典查找难题。
