如何确保Python Wheel安装时至少指定一个可选依赖？

目前setuptools和pip本身没有直接支持“强制用户选择至少一个extra”的内置机制，但可以通过两种变通方法实现你的需求：

方法一：运行时检查（最可靠推荐） #

在你的主包核心模块（比如my_package/__init__.py）里添加检查逻辑，当用户尝试使用包但未安装任何可选依赖时，抛出明确的错误提示：

# my_package/__init__.py
try:
    # 尝试导入第一个可选依赖
    import dep1
except ImportError:
    try:
        # 尝试导入第二个
        import dep2
    except ImportError:
        try:
            # 尝试导入第三个
            import dep3
        except ImportError:
            raise ImportError(
                "请至少安装一个可选依赖！使用以下命令之一完成安装：\n"
                "pip install my_package[dep_1]\n"
                "pip install my_package[dep_2]\n"
                "pip install my_package[dep_3]"
            ) from None

这种方法的好处是不管用户用什么方式安装（直接pip、requirements.txt、wheel等），只要运行你的包就会触发检查，确保必须有一个可选依赖存在，不会出现“安装成功但无法使用”的情况。

方法二：安装阶段提示（辅助补充） #

虽然没法在pip install my_package时直接阻断安装，但可以在包的说明文档里明确强调必须选择一个extra，同时在setup.py的long_description里加上醒目的提示：

# setup.py
from setuptools import setup

setup(
    name="my_package",
    # ... 其他配置
    extras_require={
        "dep_1": ["dep1"],
        "dep_2": ["dep2"],
        "dep_3": ["dep3"],
    },
    long_description="""
# my_package

注意：安装时必须指定至少一个可选依赖！例如：
pip install my_package[dep_1]
pip install my_package[dep_2]
pip install my_package[dep_3]

... 其他文档内容
""",
)

这样用户在查看包说明时，会提前看到要求，减少误操作的可能。

为什么不推荐安装时强制阻断？ #

因为pip的安装流程中，当用户不指定extra时，setup.py无法直接获取这个状态信息，强行通过hack方式（比如解析pip命令参数）实现的话，很难兼容各种安装场景（比如从wheel安装、通过requirements.txt安装、虚拟环境内外安装等），容易出问题，反而不如运行时检查可靠。

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