--junitxml 必须指定具体文件路径（如 reports/test-results.xml），不支持目录；需配合 --junit-logs 和 --junit-family=xunit2 确保日志和失败信息完整输出，推荐在 pytest.ini 中配置以保障 ci 稳定性。
pytest --junitxml 参数必须指定文件路径，不能只写目录
pytest 生成 JUnit XML 报告靠的是 --junitxml，但它不接受目录，只接受具体文件路径。常见错误是写成 --junitxml=reports/ 或 --junitxml=reports，结果 pytest 静默失败，不报错也不生成报告。
正确做法是明确到文件名，比如：--junitxml=reports/test-results.xml。目录 reports/ 必须事先存在，pytest 不会自动创建父目录。
- 路径中不要用波浪号
~，--junitxml=~/test.xml会被当字面量处理，导致写入失败 - Windows 下路径分隔符用正斜杠
/更稳妥（如reports/test.xml），pytest 内部能正确解析 - 如果路径含空格，命令行里要加引号，但
--junitxml值本身不用引号包裹（pytest 自己解析）
XML 输出默认不包含 stdout/stderr，需加 --junit-logs
默认情况下，--junitxml 只记录测试状态、耗时和失败断言，print() 输出或异常 traceback 不会进 XML。CI 系统（比如 Jenkins）常依赖这些日志定位问题，漏掉就很难排查。
加上 --junit-logs 才能把 stdout 和 stderr 内容写进 <system-out></system-out> 和 <system-err></system-err> 标签里。
- 这个参数从 pytest 6.2 开始支持，旧版本（如 5.x）不识别，会报错
unrecognized arguments: --junit-logs - 它不影响控制台输出，只是决定是否塞进 XML；没加也不影响测试执行本身
- 如果你用 pytest-xdist 并行跑，各进程的 stdout 会混在一起写入同一个 XML，顺序不可靠——这不是 bug，是设计如此
失败测试的 message 和 traceback 被截断，由 junit_family 控制
XML 里 <failure></failure> 的 message 属性默认只放断言错误的简短描述（比如 AssertionError: assert 0 == 1），完整 traceback 在 里。但某些 CI 工具只读 message，看不到堆栈。
用 --junit-family 可切换格式：--junit-family=xunit2 会让 message 包含第一行 traceback，更友好；xunit1（默认）则较简略。
-
xunit2是推荐值，Jenkins、GitLab CI 都兼容，且 message 字段更实用 - 别写成
--junit-family="xunit2"—— pytest 不吃引号，会当成非法值报错 - 这个选项不影响 XML 结构合法性，只改内容组织方式，和
--junit-logs可叠加使用
pytest.ini 里配置比命令行更稳定，尤其在 CI 中
把参数写死在 pytest.ini 里，比每次在 CI 脚本里拼命令可靠。命令行容易漏参数、顺序错、引号乱，而配置文件一次写对，所有环境自动生效。
在项目根目录放 pytest.ini，内容类似：
[tool:pytest] junitxml = reports/test-results.xml junit_logs = true junit_family = xunit2
注意：ini 文件里布尔值写 true/false，不是 True 或 1；路径是相对 pytest 执行位置的，不是相对于 ini 文件。
- 如果同时在命令行和 ini 里设了
junitxml，命令行优先，但其他选项（如junit_logs）会合并 - Pytest 7+ 推荐用
pyproject.toml，但字段名要改成addopts包裹，例如addopts = ["--junitxml=reports/test.xml", "--junit-logs"]，不如 ini 直观 - CI 环境里常因工作目录不一致导致路径失效，用绝对路径（如
/workspace/reports/test.xml）反而更稳
--junit-family 和 --junit-logs 的组合，还有 pytest 版本能不能吃下这些参数。很多人配完发现 Jenkins 里点不开日志，八成卡在这两个开关上。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
