python 3.12 下 pytest 运行失败主因是 setuptools 版本不兼容：≤67.x 会报路径绝对错误，
Python 3.12 下 pytest 运行失败，八成不是 pytest 本身的问题，而是被 setuptools 的构建逻辑卡住——尤其当你看到 ValueError: path 'xxx' cannot be absolute 或 AttributeError: module 'pkgutil' has no attribute 'ImpImporter' 这类报错时。
pip install pytest 失败并报 ValueError: path ... cannot be absolute
这是 h5py、d2l 等含 C 扩展的库在 Python 3.12 下构建时的典型症状，根源是旧版 setuptools（≤67.x）仍尝试解析硬编码绝对路径，而 3.12 对 MANIFEST.in 和内部路径校验更严格。
- 先升级构建工具链：
pip install --upgrade pip setuptools wheel - 若仍失败，说明某个依赖（如 h5py==3.10.0）源码里嵌了不兼容路径；临时解法是降级 setuptools 到
setuptools==67.0.0（它保留了对旧路径模式的兼容） - 长期方案是换用二进制轮子（wheel）：查 PyPI 上对应库是否已发布
cp312标签的 wheel，优先安装 wheel 而非源码
pytest 启动时报 AttributeError: module 'pkgutil' has no attribute 'ImpImporter'
这不是 pytest 报的错，而是你项目里某个依赖（比如老版本 d2l、某些自定义 setup.py）还在用已被移除的 pkgutil.ImpImporter。Python 3.12 彻底删掉了这个类。
Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。
- 运行
pip show setuptools确认版本 ≥68.0.0；低于此值必须升级 - 检查
requirements.txt中是否有显式指定旧 setuptools（如setuptools），删掉或放宽约束 - 若问题来自某个第三方包（如 d2l），查看其 GitHub issues 是否已有 patch；没有就 fork 后手动删掉 setup.py 里所有
pkgutil.ImpImporter相关代码
pytest 8.x 运行时触发 DeprecationWarning: pkg_resources is deprecated
警告本身不中断执行，但暴露了插件生态滞后——pytest 8.2+ 已迁移到 importlib.metadata，但 pytest-html、pytest-xdist 等老插件还在用 pkg_resources.get_distribution()。
- 加
-W error::DeprecationWarning让警告变异常，快速定位是哪个插件触发的 - 升级对应插件：例如
pytest-html>=4.1.1、pytest-xdist>=3.5.0（这些版本已适配importlib.metadata） - 若插件无更新，临时在 conftest.py 顶部加
import warnings; warnings.filterwarnings("ignore", category=DeprecationWarning, module="pkg_resources")，但别长期依赖
真正麻烦的从来不是“装不上”，而是错误堆栈里混着 setuptools、pkg_resources、pytest 三层报错，让人分不清该升级谁——建议按 pip list | grep -E "(setuptools|pytest|wheel)" 先锁定三者版本，再对照报错关键词逐层排查。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
