如何在Python包中实现条件安装？以向后兼容库为例

一、正确配置条件依赖 #

你的条件依赖写法本身没问题，失效大概率是因为使用的setuptools版本过低（低于42.0.0不支持环境标记语法）。推荐采用当前主流的pyproject.toml配置，同时兼容setup.cfg的写法：

1. 使用pyproject.toml（推荐） #

在项目根目录的pyproject.toml中添加：

[project]
dependencies = [
    "importlib_resources>=5.0; python_version < '3.9'"
]

2. 使用setup.cfg #

确保setuptools版本≥42.0.0，然后在setup.cfg中配置：

[options]
install_requires =
    importlib_resources>=5.0; python_version < '3.9'

配置后，安装时会自动根据Python版本判断是否安装importlib_resources：Python 3.8及以下会安装该库，3.9及以上则跳过。

二、实现跨版本别名 #

要让Python 3.9+中importlib_resources直接映射到标准库的importlib.resources，有两种可靠方式：

方法1：在项目包的__init__.py中配置 #

在你自己的项目包根目录的__init__.py中添加以下代码：

import sys

if sys.version_info >= (3, 9):
    # 3.9+ 直接映射到标准库模块
    from importlib import resources as importlib_resources
else:
    # 低版本使用第三方库
    import importlib_resources

之后在项目的任何代码文件中，都可以统一使用：

from importlib_resources import files

方法2：全局模块别名（更彻底） #

如果希望项目中所有模块都能直接import importlib_resources而无需额外导入逻辑，可以在项目的入口文件（比如main.py）或单独的兼容性模块（比如compat.py）中添加：

import sys

if sys.version_info >= (3, 9):
    from importlib import resources
    # 注册全局模块别名
    sys.modules['importlib_resources'] = resources
else:
    import importlib_resources

只需在项目启动时先加载这段代码，后续所有import importlib_resources都会自动指向正确的实现。

三、验证方案 #

1. 依赖安装验证：在Python 3.8环境下执行pip install .，会看到importlib_resources被安装；在Python 3.9+环境下执行则不会安装该库。
2. 代码功能验证：在两个版本的Python中运行from importlib_resources import files，均能正常获取files对象，无需修改业务代码。

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