pytest 4.0.0 发布全解析：RemovedInPytest4Warning 升级为错误与 node id 格式变更
【免费下载链接】pytestThe pytest framework makes it easy to write small tests, yet scales to support complex functional testing项目地址: https://gitcode.com/GitHub_Trending/py/pytest
pytest 4.0.0（2018-11-13 发布）是 pytest 团队在完成 3.x 系列迭代后推出的第一个 4.x 大版本，它遵循既定的弃用（deprecation）节奏，把面向 4.x 的RemovedInPytest4Warning类警告默认升级为错误，并移除了 node id 中表示测试类实例的::()记法，同时引入了基于$TOX_ENV_DIR的 tox 环境级缓存目录前缀。本篇文章以官方发布公告 release-4.0.0.rst 为骨架，结合仓库内 CHANGELOG 中 pytest 4.0.0 的完整条目 与对应源码实现，帮助读者理解这一里程碑版本的技术变化、升级注意事项与背后的实现细节。
一、版本背景与发布公告要点
1.1 发布公告核心信息
官方发布公告 release-4.0.0.rst 明确指出：
- 4.0.0 是 pytest 项目的一个大版本（major release），包含大量 bug 修复与改进；
- pytest 是一个成熟的 Python 测试工具，仓库自身拥有 2000+ 测试用例，覆盖多种解释器与平台；
- 用户被鼓励仔细阅读完整的 CHANGELOG，其中包含本版本的完整变更明细；
- 升级方式沿用 PyPI 标准做法：
pip install -U pytest； - 向本版本的主要贡献者致谢，包括 Bruno Oliveira、Daniel Hahler、Ronny Pfannschmidt 等。
值得注意：发布公告本身是一份面向社区的通告，技术细节全部沉淀在 CHANGELOG.rst（当前仓库的变更日志源文档为 doc/en/changelog.rst）。下文的技术内容均以 changelog 中pytest 4.0.0 (2018-11-13)一节为准。
1.2 3.10 到 4.0 的升级路径
4.0.0 与上一个 bug fix 版本 3.10.1 间隔约两个月。3.10.x 系列承担了大量稳定性工作（如修复--pdbcls回归、命名空间包的monkeypatch.syspath_prepend缓存失效、重复收集等），而 4.0.0 则集中处理面向未来的破坏性变更，是典型的"先稳定、后清理"的发布策略。
二、Removals：两大破坏性变更详解
2.1RemovedInPytest4Warning由警告升级为错误（issue 3737）
这是 4.0.0 最核心的破坏性变更。按照 pytest 既定的弃用计划，所有类型为RemovedInPytest4Warning的警告默认不再以警告形式打印，而是直接升级为错误（error）。受影响的功能将在 pytest 4.1 中被真正移除，因此所有在 3.x 时代收到过该类警告的用户，都必须在升级到 4.0.0 后、4.1 发布前完成代码迁移。
临时缓解方案（仅限 4.0.x 系列）：如果团队暂时无法完成迁移，可以在pytest.ini中把错误降级回警告：
[pytest] filterwarnings = ignore::pytest.RemovedInPytest4Warning但官方明确警告：该配置在 pytest 4.1 发布后即失效，因此它只能作为短期过渡手段，不能替代真正的代码更新。若对某个具体功能的移除有异议，官方建议在 issue 4348 中留言讨论。
从源码结构看，pytest 的警告体系以PytestWarning为基类，PytestDeprecationWarning(PytestWarning, DeprecationWarning)是面向"未来版本移除"的弃用警告基类，其定义可见 src/_pytest/warning_types.py。RemovedInPytest4Warning正是这一体系的早期成员——它在 3.8.0（issue 2452）被引入，用于标记"将在 pytest 4 移除"的废弃 API；而 4.0.0 正是这一弃用周期的兑现点：先升级为错误，再在下一版本彻底删除。
2.2 移除 node id 中的::()实例记法（issue 4358）
在 4.0.0 之前，包含测试类实例的 node id 会写成：
test_foo.py::Test::()::test_bar其中的::()表示"测试类的实例"这一层级。该记法对大多数用户而言晦涩难懂，并且在内部一些地方已被提前移除，导致在--deselect等场景（issue 4127）中出现不一致的困惑。4.0.0 正式移除该记法，node id 简化为：
test_foo.py::Test::test_bar两个相关行为变化需要特别注意：
--deselect的写法必须同步更新：凡是基于旧 node id 的--deselect、-k表达式或命令行精确节点选择，都需要去掉::()段；--collect-only不再单独列出测试类实例：收集清单的输出层级也相应简化。
关于 node id 的结构，可以结合当前仓库的 src/_pytest/nodeid.py 来理解：nodeid 是::分隔的字符串，形如path/to/test_file.py::TestClass::test_method[param]，由"rootpath 相对路径 +::段名称 + 可选参数段"组成。4.0.0 的变更实质上是把"路径段"压缩为"类段 + 方法段"两层，::()这一纯标记性层级被删除。测试类实例在收集清单中也不再以独立节点呈现。
三、Features：tox 环境级缓存目录（issue 4270）
4.0.0 为缓存目录引入了一个实用的新特性：cache_dir选项默认使用$TOX_ENV_DIR作为前缀（当该环境变量存在时）。
[pytest] cache_dir = .pytest_cache在 tox 场景下，每个 tox 环境会设置独立的$TOX_ENV_DIR，因此该特性意味着每个 tox 环境默认拥有独立的缓存目录，避免多个 tox 环境（如不同 Python 版本、不同依赖组合）共享.pytest_cache时相互污染--lf/--ff/-x等依赖缓存的状态数据。
从当前源码实现看，缓存目录的解析路径为Cache.cache_dir_from_config()，它通过config.getini("cache_dir")读取配置并用resolve_from_str()解析为绝对路径，见 src/_pytest/cacheprovider.py。缓存目录的创建则是原子化的：_make_cachedir()先创建临时目录并写入README.md、.gitignore、CACHEDIR.TAG等支撑文件，再原子重命名到目标位置，见 src/_pytest/cacheprovider.py。这种设计保证了并行进程下缓存目录创建的安全性。缓存内容按类型存放在d/（目录）与v/（值）两个子目录下，其中v/存放--last-failed、--failed-first、--stepwise等插件使用的"上轮失败节点"数据。
四、Bug Fixes：本版本唯一的修复项
- issue 3554：修复
CallInfo.__repr__在调用尚未结束时（即仍处于CallInfo的"进行中"状态）的表现。CallInfo是 pytest 内部用于封装"调用某 fixture 或钩子函数结果（返回值或异常）"的数据结构，此前对未完成的调用打印 repr 会出错，修复后可以安全地进行调试输出。
这一条目也印证了 4.0.0 的定位：它主要承担"按计划清理旧 API"，而非引入大量新特性。
五、升级到 pytest 4.0.0 的完整行动清单
结合发布公告与 changelog，给出面向用户的升级 checklist：
- 检查
RemovedInPytest4Warning：在 3.x 上运行完整测试套件，收集所有RemovedInPytest4Warning，逐项按 deprecations 文档 迁移到新 API（如用getfixturevalue替代getfuncargvalue等）； - 更新 node id 相关配置：修正所有硬编码的
::()node id（--deselect、CI 脚本、精确节点选择参数）； - 确认
--collect-only输出差异：调整依赖收集输出的脚本或工具； - 执行升级：
pip install -U pytest； - 短期过渡（如需）：在
pytest.ini中加入ignore::pytest.RemovedInPytest4Warning，并在 4.1 发布前完成迁移； - 验证 tox 缓存隔离：若使用 tox，确认各环境缓存独立、
--lf/--stepwise行为符合预期。
六、总结与后续影响
pytest 4.0.0 是一个"清理型"大版本：通过把RemovedInPytest4Warning升级为错误，强制用户直面历史弃用 API 的迁移；通过移除::()记法，让 node id 体系更加简洁一致；通过$TOX_ENV_DIR前缀，让 tox 多环境下的缓存互不干扰。这些变化为后续 4.x 系列（4.0.1、4.0.2……）的稳定性工作扫清了障碍。对仍然维护老测试库的团队而言，理解本版本的变更清单，是平滑完成从 3.x 到 4.x 迁移的第一步。
【免费下载链接】pytestThe pytest framework makes it easy to write small tests, yet scales to support complex functional testing项目地址: https://gitcode.com/GitHub_Trending/py/pytest
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
