想要给你的Django项目做测试，不用再头疼环境搭建和用例编写，借助pytest-django可以轻松实现从单元测试到集成测试的完整落地，接下来咱们就一步步拆解整个实践过程，从环境配置到代码编写，再到场景分析，让不同基础的开发者都能看懂、能上手。
一、先搭好用的测试环境
1.1 安装需要的依赖
首先要安装pytest核心库和适配Django的pytest-django插件，这里用指定版本避免后续出现兼容问题，直接执行bash命令就行：
# 安装pytest-django和对应版本的Django
pip install pytest-django==4.5.2 Django==3.2.20
1.2 配置pytest
在你的Django项目根目录（和manage.py同层级）新建pytest.ini文件，用来告诉pytest你的项目设置和测试文件命名规则：
[pytest]
# 这里换成你自己项目的settings路径，比如你的项目叫myproject，就是myproject.settings
DJANGO_SETTINGS_MODULE = myproject.settings
# 匹配测试文件的命名规则，只要是test开头或结尾的py文件都会被识别为测试文件
python_files = test_*.py *_tests.py tests.py
# 默认运行测试时显示详细信息，不用每次手动加-v参数
addopts = -v
配置完之后，pytest就知道怎么对接你的Django项目了，接下来就可以写测试代码了。
二、从单元测试开始：测单个小逻辑
单元测试的核心是测最小的、独立的代码单元，比如一个工具函数、一个纯计算的方法，不需要依赖数据库或者其他外部服务，跑起来特别快，适合快速验证核心逻辑有没有错。
2.1 单元测试的核心逻辑
单元测试就是把要测的代码单元（比如函数）取出来，给它喂不同的输入，然后判断输出是不是符合预期，就像你给计算器输入数字，看它是不是算出正确结果一样。
2.2 完整的单元测试示例
咱们先拿一个工具函数举例，假设你的项目里有个处理用户手机号的小函数，用来把用户输入的带空格或横杠的手机号转成纯数字格式，放在myapp/utils.py里：
# myapp/utils.py
def format_phone(phone):
"""把用户输入的手机号去掉所有空格和横杠，方便后续存储"""
# 先去掉所有空格，再去掉所有横杠，返回纯数字字符串
return phone.replace(" ", "").replace("-", "")
接下来写单元测试文件，放在myapp/tests/test_utils.py里，这个文件就是专门测这个工具函数的：
# myapp/tests/test_utils.py
import pytest
from myapp.utils import format_phone
# 测试手机号带空格的场景：用户输入"138 0013 8000"
def test_format_phone_with_space():
# 调用要测的函数，传入带空格的手机号
result = format_phone("138 0013 8000")
# 断言输出是不是预期的纯数字手机号
assert result == "13800138000"
# 测试手机号带横杠的场景：用户输入"138-0013-8000"
def test_format_phone_with_dash():
result = format_phone("138-0013-8000")
assert result == "13800138000"
# 测试手机号同时有空格和横杠的场景：用户输入"138 - 0013 8000"
def test_format_phone_with_both_space_and_dash():
result = format_phone("138 - 0013 8000")
assert result == "13800138000"
写完之后，直接用bash命令运行单元测试就行，pytest会自动识别测试文件：
# 只运行这个工具函数的单元测试，快速验证逻辑
pytest myapp/tests/test_utils.py -v
如果所有测试都通过，会显示3个passed，说明这个函数的三个分支逻辑都没问题。
三、进阶到集成测试：测模块交互流程
单元测试只测单个代码单元，没法测模块之间的交互，比如视图函数和工具函数的配合、视图和数据库的对接，这时候就需要集成测试，把几个关联的模块放在一起测，看它们能不能正常协作。
3.1 集成测试的核心逻辑
集成测试的核心是模拟真实的用户操作，比如模拟浏览器发送请求，看Django的视图是不是正常处理，是不是返回正确的结果，或者数据库是不是存对了数据，这时候需要用到pytest-django提供的预制工具，比如模拟请求的client、初始化测试数据库的django_db。
3.2 完整的集成测试示例
假设你有个用户注册的视图函数，放在myapp/views.py里，这个视图会接收POST请求的手机号，调用工具函数格式化后返回结果：
# myapp/views.py
from django.http import JsonResponse
from myapp.utils import format_phone
def register_user(request):
"""处理用户注册的视图，只接受POST请求"""
if request.method != "POST":
# 不是POST请求返回错误
return JsonResponse({"code": 405, "msg": "仅支持POST请求"})
# 从POST请求里取手机号参数
phone = request.POST.get("phone")
if not phone:
return JsonResponse({"code": 400, "msg": "手机号必填"})
# 调用工具函数格式化手机号
formatted_phone = format_phone(phone)
# 这里简化了，实际会存到数据库，现在直接返回结果
return JsonResponse({
"code": 200,
"msg": "注册成功",
"formatted_phone": formatted_phone
})
接下来写集成测试文件，放在myapp/tests/test_views.py里，这个文件会模拟请求视图的流程：
# myapp/tests/test_views.py
from django.urls import reverse
# 这个client是pytest-django提供的fixture，相当于一个模拟浏览器的客户端
def test_register_view_post_success(client):
# 用reverse获取注册接口的路径，不用硬编码，避免路径写错
url = reverse("register_user")
# 模拟发送POST请求，传入带空格的手机号，和单元测试的场景对应
response = client.post(url, {"phone": "138 0013 8000"})
# 断言响应状态码是200，说明请求成功
assert response.status_code == 200
# 断言返回的消息是正确的
assert response.json()["msg"] == "注册成功"
# 断言手机号已经被正确格式化，验证了视图和工具函数的配合
assert response.json()["formatted_phone"] == "13800138000"
# 测试GET请求的场景，验证接口的请求方法限制
def test_register_view_get_method_not_allowed(client):
url = reverse("register_user")
# 模拟发送GET请求，不符合注册要求
response = client.get(url)
# 断言状态码是405，提示方法不允许
assert response.status_code == 405
assert response.json()["msg"] == "仅支持POST请求"
运行集成测试的话，因为涉及到数据库和Django请求，需要用django_dbfixture，pytest-django会自动帮你初始化一个临时测试数据库，不会影响你的正式库，直接执行bash命令：
# 运行视图的集成测试，验证整个请求流程
pytest myapp/tests/test_views.py -v
所有测试通过的话，说明你的注册视图和工具函数的交互是正常的，接口限制也生效了。
四、搞懂场景、优缺点和注意事项
4.1 不同测试的应用场景
单元测试适合测纯逻辑、无依赖的代码，比如工具函数、算法、模型的纯字段计算，适合开发时快速迭代，改了代码就能马上跑测试，不用等待其他环境；集成测试适合测模块之间的交互、API接口、数据库操作，比如用户注册的整个流程、订单生成的逻辑，适合发布前的整体验证，确保功能能正常跑。
4.2 单元与集成测试的优缺点
单元测试的优点是跑的快、定位准、依赖少，比如刚才的单元测试几毫秒就跑完，要是错了直接知道是工具函数的问题；缺点是测不到真实交互，比如如果视图里的参数传错了，单元测试工具函数测不出来，因为它没用到视图。集成测试的优点是覆盖真实场景，能发现模块间的问题，比如视图和工具函数的配合错了，集成测试会爆；缺点是跑的慢、依赖多，需要数据库、Django环境，跑一次可能要几秒到几十秒，而且容易受外部环境影响，比如数据库版本变了可能测试不过。
4.3 写测试的注意事项
单元测试要覆盖所有分支，比如刚才的工具函数，除了带空格、带横杠，还要加边界情况，比如手机号为空？虽然例子里没写，但实际要考虑；要避免依赖外部，单元测试别连数据库，不然就不是单元测试了。集成测试要聚焦模块交互，别写太粗的测试，比如把整个项目的接口都测了，要只测你关心的模块；要正确使用fixture，需要数据库就加django_db，需要模拟请求就用client，不用自己写重复的预制代码，另外，运行的时候可以分开跑，比如开发时只跑单元测试，发布前跑集成测试，节省时间。
五、总结
用pytest-django写测试其实没那么复杂，从单元测试到集成测试，本质就是从测单个逻辑到测整体流程的过渡，两者结合起来就能给你的Django项目搭起一个基本的测试体系。单元测试帮你守住核心逻辑的底线，集成测试帮你确保功能能正常用，写的时候记得分开管理测试文件，别混在一起，出问题的时候能快速找到是哪个环节的错，这样不管是自己开发还是团队协作，都能少踩bug的坑，项目的稳定性也会好很多。
Comments