allure报告需allure-pytest插件生成json数据并用allure cli渲染html；必须安装两者，指定--alluredir输出目录，用allure serve预览或allure generate生成静态页。
装allure-pytest插件和Allure命令行工具
Pytest本身不生成Allure报告，必须靠 allure-pytest 插件把测试数据转成Allure能读的JSON格式，再用Allure CLI解析渲染。只装Python包不够，allure-commandline 也得装上。
- 用pip装Python端：
pip install allure-pytest - 用SDKMAN、Homebrew或手动下载装Allure CLI（推荐Homebrew）：
brew install allure；Windows用户建议从 GitHub releases页 下最新allure-*.zip，解压后把bin/加进PATH - 验证是否装好：
allure --version和pytest --help | grep allure都应有输出
运行pytest时加--alluredir参数生成原始数据
Allure报告是两阶段生成：先跑测试写JSON，再用Allure命令读JSON生成HTML。关键在第一阶段——必须显式指定输出目录，否则 allure-pytest 不会存任何中间文件。
- 执行命令示例：
pytest tests/ --alluredir=./allure-results -
--alluredir路径必须是空目录或不存在的路径，Allure不会自动清旧数据，重复运行会混入历史结果 - 如果用了
--clean-alluredir，它只清目录内容，不删目录本身；但该参数不是默认开启的，要手动加 - 生成的
./allure-results里全是xxx-result.json和attachment-xxx，别直接改或删它们
用allure serve启动本地预览服务
直接用 allure generate 生成静态HTML也能看，但 allure serve 更方便：自动监听变更、支持实时刷新、内置HTTP服务，适合开发调试阶段。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
- 命令：
allure serve ./allure-results - 它会在随机端口（如
http://127.0.0.1:56487）起服务，终端会打印URL，点开就行 - 每次重新运行
pytest --alluredir=...后，allure serve会自动检测到新数据并热重载页面（不用手动刷新） - 注意：关闭终端即关服务；如果端口被占，Allure会换一个，不会报错卡住
常见失败原因：json解析失败或报告空白
报告打不开、页面空、控制台报 Could not parse json，90% 是因为JSON文件损坏或路径不对，而不是代码写错了。
- 检查
--alluredir指向的目录里有没有.json文件——没有说明 pytest 根本没调用 allure 插件，确认是否漏了allure-pytest安装，或 pytest.ini 中禁用了插件 - 如果 JSON 文件存在但报告空白，用
cat ./allure-results/*.json | head -20看前几行是不是合法JSON（开头是{，不是乱码或 Python 异常堆栈） - 测试函数里用了
print()或logging，默认会被Allure当附件捕获；如果输出含不可见控制字符（比如ANSI颜色码），可能导致单个JSON解析失败，连带整份报告异常——可在pytest命令后加--no-header --tb=no试试 - CI环境里用
allure generate时，务必加-o指定输出目录，且确保该目录可写；漏掉-o会静默失败，不报错也不生成HTML
真正麻烦的不是生成步骤，而是结果目录生命周期管理——没人清理 allure-results，几次迭代后JSON文件堆积、serve响应变慢、generate耗时飙升。CI脚本里记得加 rm -rf allure-results，本地开发也建议 alias 一个带清理的测试命令。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
