Pytest安装Allure插件后--alluredir报错主因是未装allure-pytest包或Allure CLI未配置；需pip install allure-pytest并下载CLI、配PATH；测试中须导入allure、用@allure.title等标注，步骤中避免耗时操作；生成报告前确认allure-results含JSON文件、路径无中文空格；CI中须用allure generate导出静态HTML并归档。
Pytest安装Allure插件后为什么pytest --alluredir报错？
常见原因是allure-pytest未安装，或系统未装Allure CLI。仅装Python包不够，Allure报告生成依赖Java运行的命令行工具。
- 先执行
pip install allure-pytest（注意不是allure-python） - 再下载Allure CLI：从GitHub releases下载zip，解压后把
bin/目录加入PATH - 验证：终端运行
allure --version，有输出才说明CLI就绪 - 若仍报
command not found: allure，说明环境变量没生效，重启终端或重载~/.zshrc/~/.bash_profile
测试用例里怎么加Allure标签和步骤描述？
Allure的@allure.feature、@allure.step等装饰器必须显式导入，且不能漏掉@allure.title这类基础标注——否则报告里显示为默认函数名，可读性极差。
- 在测试文件顶部加
import allure - 用
@allure.title("登录成功场景")替代函数名作为报告标题 - 关键逻辑块前加
@allure.step("输入用户名{username}")，参数会自动填充（注意括号用英文） -
@allure.description("覆盖密码为空校验")支持多行字符串，但别用"""包裹后缩进，否则报告里带空格 - 避免在
@allure.step里调用耗时操作（如截图），它只负责记录，不执行
生成HTML报告时allure serve打不开或空白？
根本原因通常是--alluredir指定的目录为空，或路径含中文/空格，或Allure服务端口被占。
- 确认生成命令正确：
pytest tests/ --alluredir=./allure-results（注意目录名不要写成allure-result少个s） - 检查
./allure-results下是否有*.json文件，没有说明测试没跑或插件没生效 - 启动服务用
allure serve ./allure-results，不要用open index.html——那是静态文件，缺少动态数据 - 若提示
Address already in use，加-p 5555换端口：allure serve -p 5555 ./allure-results - Mac上首次运行可能被“已损坏”拦截，需右键→“打开”，而非双击
CI环境（如GitLab CI）中Allure报告怎么持久化？
本地allure serve只是临时预览，CI里必须导出静态HTML并归档，否则流水线结束就没了。
立即学习“Python免费学习笔记（深入）”；
- 先用
allure generate ./allure-results -o ./allure-report --clean生成静态页 - GitLab CI中配置
artifacts:指向./allure-report/**/*，但注意不能直接传整个目录，要展开通配符 - Jenkins需装Allure Plugin，并在构建后操作里指定
allure-report路径 - 注意
allure generate依赖allure-results中的JSON时间戳，CI节点时区不一致会导致历史趋势图错乱
真正麻烦的是附件（截图、日志）路径绑定——Allure默认存相对路径，如果测试里用allure.attach.file()但没设name参数，报告里就只显示file两个字。
