python 3.12 彻底物理删除了 distutils 模块，源码文件被从 cpython 仓库移除，import 即报 modulenotfounderror，无警告、不可绕过；其在 sys.stdlib_module_names 中消失，pypi 无合法替代包，依赖它的 setup.py、旧科学计算库及 ide 初始化均会立即失败。
Python 3.12 并不是“删除”了 distutils，而是正式移除了一个早已失效、不再维护的模块——它在 3.12 中已物理消失，任何 import distutils 都会直接报 ModuleNotFoundError，没有警告，也不可绕过。
为什么 import distutils 会直接失败，而不是先警告？
因为从 Python 3.12 开始，distutils 的源码文件（包括 distutils/core.py、distutils/sysconfig.py 等）已被从 CPython 仓库中彻底删除。它不再是“弃用”，而是“不存在”。
你无法通过 pip install distutils 恢复它——PyPI 上没有合法的 distutils 包；所谓“兼容补丁”只是空壳或行为不一致的仿制品，不能修复继承、命令注册等底层逻辑。
系统级的 sys.stdlib_module_names 列表里也查不到它，这是“真删除”的信号。
哪些代码会立刻崩？
常见触发点往往不在你自己的脚本里，而在依赖链中：
安全 Python 代码沙箱：在隔离的沙箱中执行任意 Python 代码，预装 requests、NumPy、pandas 库。返回 stdout、stderr。
-
setup.py文件里写着from distutils.core import setup或from distutils.version import LooseVersion - 旧版科学计算包（如
APLpy、pyregion、capstone）在__init__.py或构建逻辑中硬引用distutils.sysconfig - CI 脚本执行
python setup.py install或python setup.py bdist_wheel - 某些 IDE（如 PyCharm）在启动解释器时尝试读取
distutils元数据，导致环境初始化失败
为什么不能只升级 setuptools 就完事？
新版 setuptools（≥65.5.0）确实能模拟部分 distutils 命令（比如 build_ext），但它不提供 distutils 模块本身。真正麻烦的是那些没报错但行为已变的调用：
-
distutils.dir_util.copy_tree()对符号链接的处理逻辑和shutil.copytree(..., symlinks=True)不等价 -
numpy.distutils已随 NumPy 1.24 彻底废弃，Python 3.12 下即使装了老 numpy 也无法工作 - 自定义
cmdclass继承自distutils.command.build_ext的类，必须显式改为setuptools.command.build_ext.build_ext，否则构造失败
pyproject.toml 是终点，但不是唯一解
PEP 517/621 明确要求构建入口必须是声明式配置，而非可执行脚本。这意味着：
— setup.py 不再参与实际构建流程，仅保留文档用途
— pip install . 会忽略 setup.py，转而读取 [build-system] 指定的后端（如 setuptools.build_meta）
— 即使你暂时不迁移到 pyproject.toml，也必须确保 setuptools ≥65.5.0 且虚拟环境已执行 python -m ensurepip --upgrade
最易被忽略的一点：很多项目表面替换了 from distutils 为 from setuptools，却没动 MANIFEST.in 里的 include 规则——新版 setuptools 更倾向用 package_data 或 data_files 显式声明资源，静默差异会在打包后才暴露。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
