python 3.12无法直接安装旧版库，因其彻底移除了distutils和pkgutil.impimporter，导致依赖两者的setup.py构建、pkg_resources模块加载及cp312标签缺失的wheel匹配全部失效。

不能直接安装，因为 Python 3.12 已彻底移除 distutils 和 pkgutil.ImpImporter，而 Python 2.7 时代遗留的依赖包（如旧版 setuptools、numpy、dm-tree）普遍依赖这两者完成构建或模块加载。

pip install 报 ModuleNotFoundError: No module named 'distutils'

这是最典型的信号。Python 3.12 不再包含 distutils 模块——它被物理删除，不是弃用警告。只要依赖包的 setup.py 或构建流程中隐式调用了 distutils.core.setup（哪怕只是通过老版 setuptools fallback），pip 就会在元数据准备阶段直接崩溃。

• 常见触发：执行 pip install -r requirements.txt 时卡在 Preparing metadata (setup.py)
• 即使你用 --only-binary=all，旧 wheel 文件名里没有 cp312 标签，pip 会跳过所有匹配项，报 No matching distribution found
• 某些 CI 镜像自带的 pip 22.x 会反复尝试 fallback，陷入死循环，不报错也不继续

AttributeError: module 'pkgutil' has no attribute 'ImpImporter'

这是第二道硬性断点。Python 3.12 同步移除了 pkgutil.ImpImporter 和 ImpLoader，而很多旧包（尤其是通过 pkg_resources 解析 entry points 的库）会在安装后或首次 import 时触发该路径。

Pipeworx could-have-been-email

分析会议记录，判断是否可以用邮件替代，返回填充词计数和决策。

下载

• 典型表现：pip install 看似成功，但运行时 import 失败，堆栈指向 pkg_resources 或 setuptools 内部
• 不是版本低的问题——哪怕你升级 pip，只要底层 setuptools 版本 ≤66.x，就仍会调用已删除的 API
• setuptools==67.0.0 是最后一个兼容旧导入机制的版本，但它无法解决 distutils 缺失带来的构建失败

旧 wheel 包根本不会被 pip 考虑安装

PyPI 上绝大多数 Python 2.7 时代延续下来的包（比如 torchvision==0.14.1、keras==2.12）发布的 wheel 文件名含 cp37 到 cp311，不含 cp312。pip 的标签匹配逻辑是严格且不可绕过的。

• 你无法用 --force-reinstall 强装一个 cp311 wheel 到 Python 3.12 —— 它连下载步骤都不会进入
• conda 通道也无解：官方 pytorch channel 至今（2026年6月）未发布任何标有 py312 的构建；社区非官方包通常缺失 CUDA 支持或 ABI 验证
• 手动改 wheel 文件名后缀强行安装？会导致运行时符号缺失（如 RuntimeError: operator torchvision::nms does not exist）或 DLL 初始化失败（Windows）

真正麻烦的不是“装不上”，而是“看似装上了却在关键路径崩溃”——比如 torch.cuda.is_available() 返回 True，但 .cuda() 触发 segmentation fault。这种 ABI 层面的不兼容，调试成本远高于换版本。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！