pytest-metadata本身不主动获取元数据，仅负责将pytest_configure钩子注入的键值对写入报告；运行时元数据（如环境、分支、时间）须在pytest_configure中手动注入config._metadata，并通过request.config._metadata在测试中读取。
直接说结论：pytest-metadata 本身不主动“获取”元数据，它只负责把预设或钩子注入的键值对写入报告；你想拿到当前运行时的元数据（比如环境、分支、时间），得靠 pytest_configure 钩子手动塞进去，再通过 config._metadata 读取——但注意，这个字典在测试执行中是只读的，不能动态改。
为什么 test 函数里 print(config._metadata) 会报错？
config 对象在测试函数内部不可直接访问；pytest 的 config 是 session 级对象，只能在 fixture 或 hook 中拿到。常见错误是想在 test 里写 print(pytest.config._metadata) ——这早就被移除了，且 pytest 模块本身没 config 属性。
- 正确路径：用
request.config._metadata（在 test 内通过requestfixture 获取） - 但注意：此时
_metadata已冻结，新增键值不会生效，只反映配置阶段写入的内容 - 如果看到空字典，大概率是没在
pytest_configure里初始化或覆盖了默认值
如何在 pytest_configure 中注入运行时元数据？
这是最常用也最可靠的注入点。所有你想带进报告的动态信息（如 Git 分支、Python 版本、CI 标识），都该在这里塞进 config._metadata。
# conftest.py
import subprocess
import sys
<p>def pytest_configure(config):</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill6933" title="python-script-generator"><img
src="https://img.php.cn/upload/skill/000/000/081/179119443150703.jpg" alt="python-script-generator" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill6933" title="python-script-generator" class="overflowclass">python-script-generator</a>
<p class="overflowclass">快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。</p>
</div>
<a rel="nofollow" href="/xiazai/skill6933" title="python-script-generator" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div><h1>清掉默认的 Packages/Platform 项（可选）</h1><pre class="brush:php;toolbar:false;">config._metadata.pop("Packages", None)
# 注入自定义字段
config._metadata["Python"] = sys.version
config._metadata["GitBranch"] = (
subprocess.run(["git", "rev-parse", "--abbrev-ref", "HEAD"],
capture_output=True, text=True).stdout.strip()
or "unknown"
)
config._metadata["CI"] = "true" if "CI" in os.environ else "false"
- 别用
os.system，它不返回结果；必须用subprocess.run(..., capture_output=True) - Git 命令失败时 stdout 可能为空，要用
or "unknown"防崩 - 修改
config._metadata必须在pytest_configure钩子里，pytest_sessionstart太晚，部分插件已读取元数据
HTML 报告里 metadata 不显示？检查三个地方
pytest-html 默认会渲染 config._metadata，但不显示 ≠ 没写入。常见断点：
- 没装
pytest-html：仅装pytest-metadata不产生 HTML 报告，它只是个元数据容器 - 命令行漏了
--html=report.html，或用了--self-contained-html却没配好 JS 资源路径 -
pytest_configure在conftest.py里，但文件位置不对（必须在 root 或 test 目录下，且被 pytest 自动发现） - 字段名含空格或特殊字符（如
"Build ID"），某些旧版pytest-html会跳过渲染，改用下划线"Build_ID"
真正麻烦的是跨插件协作：比如你用 pytest-xdist 并行跑，每个 worker 都有自己的 config，pytest_configure 在每个子进程中执行一次，但 Git 分支这种信息可能一致，也可能因 checkout 状态不同而错乱——这种一致性得自己加锁或提前固化，别指望插件自动处理。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
