python 怎么返回json数据
我在写 Python 接口时，想把字典、列表或对象转换成标准 JSON 返回给前端，应该怎么做才比较规范？
使用 Python 的 json 模块进行序列化
在 Python 中，常见做法是先把数据整理成字典或列表，再使用 json.dumps() 转成 JSON 字符串。如果是 Web 框架场景，很多框架也提供了直接返回 JSON 的方法，例如 Flask 的 jsonify、Django REST Framework 的 Response。需要注意的是，日期、时间、自定义对象等类型不能直接被 JSON 序列化，通常要先转换成字符串、字典，或通过自定义编码器处理。
我看到有些代码直接返回 dict，有些代码返回的是 JSON 字符串，这两种方式在 Python 里有什么差别，接口开发时该怎么选？
区分 Python 数据结构和 JSON 文本
字典是 Python 内部的数据结构，JSON 字符串是跨语言传输的数据文本格式。Python 代码内部处理时适合用字典，传输给前端或外部系统时通常需要转成 JSON。接口开发里，如果框架支持自动序列化，直接返回字典会更方便；如果是普通函数或文件输出，就需要使用 json.dumps() 得到 JSON 字符串。
我的返回内容里包含 datetime、Decimal、对象实例这类字段，直接转 JSON 会报错，这种情况应该怎么解决？
为不可序列化类型做转换处理
JSON 只支持少数基础类型，因此 datetime、Decimal、自定义对象等需要在返回前处理。常见方式是把 datetime 转成格式化字符串，把 Decimal 转成 float 或 string，把对象实例转成字典。若使用 json.dumps()，可以通过 default 参数指定转换函数；在 Web 框架中，也可以先在视图层把这些字段整理好，再统一返回。
我希望后端返回的 JSON 结构清晰一些，前端拿到后能直接用，通常应该怎么设计字段结构？
保持字段命名统一且层级清晰
接口返回 JSON 时，建议保持字段命名统一、结构简单、层级不过深。常见做法是把状态码、提示信息、数据主体分别放在固定字段里，例如 code、message、data。对于列表数据，可以明确返回总数、分页信息和具体列表内容。结构越稳定，前端越容易解析，也越方便后续维护。