JsonResponse 全景速记

一、为什么选 JsonResponse

``在前后端分离、小程序、Vue/React 盛行的今天，90% 的接口返回都是 JSON。Django 自带的 JsonResponse 就是一把“瑞士军刀”，帮你把 Python 字典 / 列表一键变成浏览器能识别的 JSON 字符串，并自动加上正确的 Content-Type: application/json。

二、最小使用模板

from django.http import JsonResponse

def api_demo(request):
    data = {'name': 'itcast', 'age': 18}
    return JsonResponse(data)        # 等价于手动 dumps + 设置头

浏览器 / Postman 看到：

{"name": "itcast", "age": 18}

三、三个核心参数

四、常见场景与“坑”

五、源码级揭秘

JsonResponse 核心就三行：

if safe and not isinstance(data, dict):
    raise TypeError(...)
json_str = json.dumps(data, **json_dumps_params)
response = HttpResponse(json_str, content_type='application/json')

• safe=True 时，内部会强制 isinstance(data, dict)，防止你误传列表导致前端解析错误。isinstance 是 Python 内置函数，用来 “判断某个对象是不是某个类（或元组里任意一个类）的实例”。也就是说

isinstance(obj, cls) 就是“obj 是不是 cls 家的人？”

• safe=False 相当于“免责声明”：出了事开发者自己负责。

六、实战演练

1️⃣ 列表返回 + 关闭安全校验

girls = [{'name': 'Rose', 'addr': '顺义'}, {'name': 'Jack', 'addr': '昌平'}]
return JsonResponse(girls, safe=False, status=200)

2️⃣ 自定义日期格式

import json, datetime
from django.core.serializers.json import DjangoJSONEncoder

data = {'time': datetime.datetime.now()}
return JsonResponse(
    data,
    encoder=DjangoJSONEncoder
)

七、记忆口诀
“字典直接返，列表加 safe=False；中文加 ensure_ascii=False；状态码随手塞。”