直接用 json.dumps() 返回 JSON 会出错，因为 Flask 默认响应体是字符串且未设置 Content-Type: application/json，导致前端解析失败或抛 TypeError；应使用 jsonify() 自动设置 headers、状态码和编码，但其仅支持基本类型，不支持自定义类或 datetime。
为什么直接用 json.dumps() 返回 JSON 会出错
Flask 默认响应体是字符串，json.dumps() 虽然生成了 JSON 字符串，但没设置 Content-Type: application/json，前端可能解析失败，或 Flask 自带的调试器报 TypeError: The view function did not return a valid response。
常见错误现象：返回内容看着像 JSON（比如有花括号），但浏览器 Network 面板里 Response Headers 没有 Content-Type: application/json，fetch 的 .json() 报 Unexpected token。
- 必须用
jsonify()，它自动设好 headers、状态码和编码 -
jsonify()只接受 dict、list、str、int、float、bool、None，不支持自定义类或 datetime 对象（会抛TypeError: Object of type X is not JSON serializable） - 传入单个非字典对象（如
jsonify([1,2,3])）是合法的，但 Flask 旧版本（app.config['JSONIFY_PRETTYPRINT_REGULAR'] = False
jsonify() 怎么处理嵌套数据和空值
它对 None、True、False、数字、字符串都原样转，但不会帮你过滤字段或扁平化结构。如果你传一个带 datetime 的 dict，会直接崩。
使用场景：API 返回用户信息时，数据库查出的 ORM 对象常含 created_at（datetime 类型）、is_active（bool）、profile（嵌套 dict）——这些不能直接喂给 jsonify()。
立即学习“Python免费学习笔记（深入）”；
- 先手动转换：用
isoformat()处理datetime，例如"created_at": user.created_at.isoformat() - 避免传整个 ORM 实例，只构造所需字段的 dict，比如
{"id": u.id, "name": u.name, "joined": u.joined_at.isoformat()} -
jsonify()对None值保留为null，符合 JSON 规范，无需额外处理
如何返回带状态码和自定义 headers 的 JSON 响应
jsonify() 本身不支持直接设 status 或 headers，但可以链式调用 .status_code 和 .headers.set() —— 这是 Flask 的响应对象机制决定的。
性能影响：每次调用 jsonify() 都新建一个 Response 实例，但开销极小，不用优化；重点是别在循环里反复 jsonify 同一份数据。
- 改状态码：
return jsonify({"error": "not found"}).status_code = 404（注意：赋值写法在老版本 Flask 中不生效，推荐用元组形式） - 更稳妥写法：
return jsonify({"msg": "ok"}), 201（元组第二项是 status code） - 加 headers：
resp = jsonify({"data": [...]})→resp.headers["X-Api-Version"] = "v2"→return resp - 不要用
make_response(jsonify(...))套两层，冗余且易出错
遇到中文乱码或特殊字符怎么处理
默认情况下，jsonify() 会把中文转成 Unicode 转义（如 "\u4f60\u597d"），不是 bug，是 JSON 标准行为。但有些前端（尤其老版 iOS WebView）解析不稳。
兼容性影响：Python 3.8+ + Flask 2.0+ 默认禁用 ASCII 转义，中文直出；若你看到 \uXXXX，大概率是 Flask 版本低或显式设置了 app.config['JSON_AS_ASCII'] = True。
- 强制中文不转义：
app.config['JSON_AS_ASCII'] = False（推荐放在 app 初始化后） - 如果用了
jsonify()还是乱码，检查是否在 response 后又手动调了.encode('utf-8')——jsonify()已返回 UTF-8 编码的 bytes，重复 encode 会破坏 - 路径参数或 query string 里的中文不影响
jsonify()，那是 request 解析阶段的事
jsonify() 能接任意 Python 对象——它只认基础类型，别的得自己剥一层。 
