能跑通第一个接口测试脚本只需5分钟,关键在于:①用pipenv或poetry创建隔离环境并激活;②编写以test_开头的极简脚本,仅发请求、断言状态码和关键字段;③立即配置pytest.ini启用日志和详细输出;④所有requests调用必须显式设置timeout和复用session。

能跑通第一个接口测试脚本,5分钟内就能完成,前提是别跳过虚拟环境和依赖隔离这步——90%的“pip install pytest后报错”都卡在这儿。
pipenv 或 poetry 必须用,别直接 pip install
直接在系统 Python 里装 pytest 和 requests,迟早遇到包冲突、版本打架、同事跑不通等问题。这不是矫情,是工程底线。
- 用
pipenv --python 3.8创建隔离环境,再pipenv install pytest requests - 进项目目录后必须先
pipenv shell激活,所有命令才生效 - 检查是否生效:运行
which pytest,路径里得带.venv或pipenv字样,否则就是没激活 - 如果用
poetry,等价命令是poetry init→poetry add pytest requests→poetry shell
test_api.py 里只写三件事:发请求、断言状态码、检查关键字段
别一上来就封装类、加配置文件、搞 YAML 数据驱动。第一个脚本的目标是“让 pytest 认出它、跑起来、告诉你 pass 还是 fail”。其余都是干扰项。
- 文件名必须以
test_开头或结尾带_test.py,否则pytest不会自动发现 - 函数名也得是
test_开头,比如test_login_success - 最简可用示例:
import requests
<p>def test_user_list():
resp = requests.get("<a href="https://www.php.cn/link/1da5ca963ae4930bda1e0a19cc88ae87">https://www.php.cn/link/1da5ca963ae4930bda1e0a19cc88ae87</a>")
assert resp.status_code == 200
assert len(resp.json()) > 0</p>
保存后终端执行 pytest -v,看到绿色 PASSED 就算通关。
图片提示词生成器?不止如此。 马甲系统 —— 把脑海中的画面,翻译成AI能理解的专业表达。 用得越多,它越懂你:首次需要多问几句确认方向,用久了几乎一说就懂。 用得越多,它越快:缓存机制让后续对话越来越省。 RAG进化:成功案例持续入库,越跑越聪明。 输入「新手指南」查看完整功能介绍
pytest.ini 配置文件要立刻建,否则中文日志和失败详情全乱码
不配 pytest.ini,你遇到 UnicodeEncodeError、断言失败只显示 AssertionError 而看不到具体值差异,纯属自找麻烦。
- 在项目根目录新建
pytest.ini,内容至少包含:
[tool:pytest] python_files = test_*.py *_test.py python_classes = Test* python_functions = test_* addopts = -v --tb=short log_cli = true log_level = INFO log_format = %(asctime)s %(levelname)s %(message)s
--tb=short 缩短 traceback,log_cli = true 把日志打到控制台,这两项不加,调试时你会反复切日志文件。
Requests 的 timeout 和 session 复用是上线前必须补的坑
本地跑通 ≠ 稳定可用。没设 timeout 的脚本,在 CI 环境里可能卡死 5 分钟才超时;每次请求都新建 requests.Session(),token、cookie、连接池全丢,性能差还容易被服务端限流。
- 所有
requests.get()/requests.post()必须显式传timeout=(3, 7)(连接 3 秒,读取 7 秒) - 需要维持登录态的场景,用
session = requests.Session(),然后session.post(login_url, json=...),后续请求都用session.get() - 别信 “默认 timeout 是永远”,requests 默认是永不超时,生产环境这是事故隐患
框架越往后越复杂,但前三步(环境隔离、最小可运行脚本、基础配置)漏掉任何一环,后面写的每行代码都在给未来埋雷。尤其注意 pipenv shell 和 pytest.ini,它们不炫酷,但决定你能不能在明天早上十点前把第一个接口测通。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










