第2章零基础接口自动化到 Jenkins 持续集成【本地环境准备与首次跑通】

第2章 本地环境准备与首次跑通

本章目标

完成本地环境安装，并成功执行一次 python3 run.py。

1. 准备清单

• Python 3.9+
• 能打开终端
• 当前项目代码

2. 安装依赖

在项目根目录执行：

python3 -m pip install -r requirements.txt

如果安装慢，可稍后使用镜像源优化；先保证能装成功。

3. 检查环境配置

打开 config/config.yaml，确认环境 key 与地址可用。当前项目常用：

• admin_url
• sale_admin_url

后续 YAML 里的 base_url_key 必须写成上述 key 之一，否则会取不到地址。

4. 执行一键命令

python3 run.py

该命令会自动：

1. 初始化并清理报告目录
2. 调用 pytest 跑 YAML 用例
3. 输出 html_report/report.html
4. 若存在 Allure，则输出 Allure 报告

5. 如何判断是否成功

• 终端出现测试通过/失败统计
• html_report/report.html 已生成
• logs/ 中有本次日志

6. 失败时的排查顺序

1. 依赖安装失败 -> 重装 requirements.txt
2. 接口全失败 -> 检查 config/config.yaml 地址与 base_url_key 是否匹配
3. 报告没生成 -> 看 run.py 输出和 logs/

本章验收标准

• 能稳定执行 python3 run.py
• 能打开 html_report/report.html