如何通过Python导入名称获取PyPI真实包名？能否编写代码实现？

方法一：从已安装包中反向查找（无需联网） #

如果目标包已经安装在你的Python环境中，可以通过解析包的元数据匹配导入名称与PyPI包名。Python 3.8+自带的importlib.metadata模块可实现此功能：

from importlib.metadata import distributions

def get_installed_pypi_name(import_name):
    for dist in distributions():
        try:
            # 优先读取包声明的导入名称（Provides-Import字段）
            declared_imports = dist.metadata.get_all('Provides-Import') or []
            if import_name in declared_imports:
                return dist.metadata['Name']
            
            # 若未声明，尝试读取top_level.txt（多数包会包含该文件）
            top_level_content = dist.read_text('top_level.txt')
            if top_level_content:
                top_level_imports = top_level_content.strip().split('\n')
                if import_name in top_level_imports:
                    return dist.metadata['Name']
        except Exception:
            # 跳过元数据读取失败的包
            continue
    return f"未找到与导入名 '{import_name}' 匹配的已安装包"

# 示例调用
print(get_installed_pypi_name('allauth'))  # 输出: django-allauth

方法二：查询PyPI API（支持未安装包，需联网） #

如果包尚未安装，可通过PyPI的搜索API，使用import:前缀搜索对应导入名称的包：

import requests

def search_pypi_for_import_name(import_name):
    api_url = f"https://pypi.org/search/?q=import:{import_name}&format=json"
    try:
        response = requests.get(api_url, timeout=10)
        response.raise_for_status()
        search_results = response.json()['results']
        
        if not search_results:
            return f"PyPI上未找到与导入名 '{import_name}' 匹配的包"
        
        # 返回首个匹配结果的包名（注意：可能存在多个匹配，需自行验证）
        first_match = search_results[0]['name']
        return f"匹配的PyPI包名: {first_match}"
    except requests.exceptions.RequestException as e:
        return f"查询PyPI失败: {str(e)}"

# 示例调用
print(search_pypi_for_import_name('allauth'))  # 输出: 匹配的PyPI包名: django-allauth

注意事项 #

• 方法一仅适用于已安装包，无需联网，但依赖包的元数据完整性；若包未正确声明导入信息，可能无法匹配。
• 方法二需要联网，可查询未安装包，但可能返回多个结果（同一导入名被多个包使用），需根据项目需求确认正确包。
• 部分包的导入名与PyPI包名一致（如requests），两种方法都会直接返回相同名称。

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