Python3.9安装SubsAI时importlib.util模块找不到异常排查

一、pip仍要求安装importlib~=1.0.4的原因 #

• 依赖传递引入：你只删除了SubsAI自身配置文件里的依赖声明，但项目的其他依赖包（比如某个依赖库的setup.py/pyproject.toml）可能本身声明了importlib~=1.0.4的依赖要求，pip会递归解析所有依赖树，所以依然会尝试安装这个包。可以通过执行pip install . -v（本地安装项目时）查看详细日志，找到是哪个依赖包带进来的这个版本要求。
• pip缓存残留：pip会缓存之前的依赖解析结果，如果你之前在未删除依赖声明时执行过安装操作，旧的解析缓存可能还在，导致pip直接复用旧的依赖列表。
• 遗漏配置文件：你可能只修改了requirements.txt和pyproject.toml，但项目的setup.py或setup.cfg文件里还有importlib~=1.0.4的依赖声明——pip安装本地包时，会优先读取setup.py/setup.cfg中的配置，而非requirements.txt。

二、ModuleNotFoundError: No module named 'importlib.util'的原因 #

importlib~=1.0.4是为Python 2.7、Python 3.3及以下版本开发的第三方兼容包，这些旧版本的Python标准库没有importlib.util模块。但Python 3.9的标准库已经内置了完整的importlib模块（包含importlib.util），版本远高于1.0.4。当pip强行安装第三方的importlib包时，它会和Python内置的标准库模块冲突，甚至覆盖部分文件，导致找不到原本内置的importlib.util。而你在Python交互shell里能正常导入，是因为交互环境直接调用了标准库的importlib，没有被第三方包干扰。

解决步骤 #

• 定位依赖来源：执行pip install . -v（本地安装项目），查看日志里的依赖解析过程，找到引入importlib~=1.0.4的具体依赖包，尝试升级该依赖包的版本（新版本可能已经移除了对旧Python版本的兼容依赖）。
• 清理pip缓存：执行pip cache purge清除所有缓存，再重新执行安装命令，避免旧缓存干扰依赖解析。
• 检查所有配置文件：打开项目的setup.py和setup.cfg，确认其中的install_requires或类似字段里没有importlib~=1.0.4的声明，如有则删除。
• 强制跳过该依赖：如果暂时无法处理传递依赖，可以用pip install . --no-deps跳过自动依赖安装，之后手动安装项目需要的其他依赖，避免pip拉取不需要的importlib包。

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