allure index.html打不开

### 解决方案

当尝试直接在文件系统中打开 Allure 报告中的 `index.html` 文件时，可能会遇到页面卡在加载状态的问题。这主要是因为 Allure 报告依赖于 JavaScript 动态加载资源，在不经过服务器的情况下无法正常工作。

为了正确查看 Allure 报告，建议采用以下方法之一：

#### 方法一：使用 `allure serve`

通过命令行工具启动临时 HTTP 服务器来提供报告内容，可以确保所有必要的静态资源被正确加载并执行。具体操作如下所示[^3]：

allure serve /path/to/allure-results/

此命令会自动处理结果目录下的测试数据，并将其转换成可视化的 HTML 页面供浏览。

#### 方法二：使用 `allure open`

如果希望基于已存在的构建好的报告文件夹（通常命名为 `allure-report`），可以直接利用 `allure open` 命令开启本地预览模式[^4]:

allure open /path/to/allure-report/

该指令同样能够创建一个临时的服务实例以支持完整的交互体验。

这两种方式都能有效规避因直接访问HTML文件而导致的功能缺失现象。值得注意的是，无论采取哪种手段都需保证 allure 已经安装配置完毕并且路径设置无误。

对于自动化流程而言，可以在执行完 Pytest 测试用例收集完成后立即调用上述任一命令完成即时反馈。

相关问题

python allure简单使用

Python Allure是一个用于生成漂亮的测试报告的工具。它可以与各种测试框架（如、unittest等）结使用，并提供了丰富的功能和定制性。

是Python Allure的简单使用步骤：

1. 安装Allure-pytest插件：

   install allure-pytest

2. 在测试代码中添加Allure的注解：
- 导入必要的模块：

     import allure

- 在测试方法上添加`@allure.feature`和`@allure.story`注解，用于标记测试用例所属的功能和故事：

     @allure.feature("登录功能")
     @allure.story("用户登录")
     def test_login():
         # 测试代码
         pass

- 在测试方法内部添加`@allure.step`注解，用于标记测试步骤：

     @allure.step("输入用户名和密码")
     def input_username_and_password():
         # 测试步骤代码
         pass

3. 运行测试用例并生成Allure报告：
- 使用pytest运行测试用例，并生成Allure结果文件：

     pytest --alluredir=./results

- 生成Allure报告：

     allure generate ./results -o ./report --clean

4. 查看生成的Allure报告：
打开生成的Allure报告文件夹`./report/index.html`，即可查看漂亮的测试报告。

pytest生成中文allure报告

要生成中文allure报告，需要进行以下步骤：

1. 安装pytest和allure-pytest插件

pip install pytest
pip install allure-pytest

2. 在pytest.ini文件中添加如下内容：

[pytest]
addopts = -s --alluredir=./report/xml
testpaths = ./testcases
python_files = test_*.py
python_classes = Test*
python_functions = test_*

这里指定了测试用例所在的文件夹路径，测试文件名和测试类名的匹配规则。

3. 执行测试用例并生成xml格式的测试结果文件

pytest --alluredir=./report/xml

4. 安装中文语言包

allure install allure-language-pack-zh

5. 生成html格式的中文报告

allure generate ./report/xml -o ./report/html --clean

6. 打开report/html/index.html文件即可查看中文报告。

注意：如果在生成报告时遇到问题，可以尝试更新allure-pytest插件和allure语言包。