代码收藏家技术教程 2025-04-07

Python中json和jsonify模块的使用详解

一、json和jsonify概述

二、json模块的常用方法

1. 序列化（将Python对象转换为JSON格式字符串）

2. 反序列化（将JSON格式字符串转换为Python对象）

json.loads(json_string)

json.load(fp)

三、Flask中的jsonify函数

四、json与jsonify的区别

在Python中，json和jsonify是两种用于处理JSON数据的重要工具，但它们的使用场景和功能有所不同。

一、json和jsonify概述

json是Python标准库中的一个模块，用于处理JSON（JavaScript Object Notation）数据。JSON是一种轻量级的数据交换格式，可以在不同编程语言中实现数据交互，易于人阅读和编写，同时也易于机器解析和生成。jsonify是Flask框架提供的一个函数，用于将数据转换为JSON格式的响应对象。它主要用于在Flask应用中构建返回JSON数据的路由。

二、`json`模块的常用方法

1. 序列化（将Python对象转换为JSON格式字符串）

(1)json.dumps(obj, ensure_ascii=True, indent=None, separators=None, sort_keys=False)

obj：要序列化的Python对象，如字典、列表等。

ensure_ascii：参数默认为True，如果设置为False，可以输出非ASCII字符（比如汉字），否则会将非ASCII字符转义。

indent：用于指定缩进，可以让输出的JSON字符串的可读性更好。例如，indent=2表示缩进2个空格。

separators：用于指定分隔符，默认是(',', ': ')，可以通过设置其他值来减少生成的JSON字符串的大小。

sort_keys：为True时，会按照字典的键的顺序排序。

例如：

 import json
 data = {'name': '张三', 'age': 30, 'city': '北京'}
 json_str = json.dumps(data, ensure_ascii=False, indent=2)
 print(json_str)

输出：

 {
     "name": "张三",
     "age": 30,
     "city": "北京"
 }

(2)json.dump(obj, fp, ensure_ascii=True, indent=None, separators=None, sort_keys=False)

和dumps类似，不过dump是将序列化后的JSON数据直接写入到文件对象fp中。例如：

 with open('data.json', 'w', encoding='utf-8') as f:
     json.dump(data, f, ensure_ascii=False, indent=4)

这段代码会在当前目录下生成一个data.json文件，内容和上面dumps的输出相同。

2. 反序列化（将JSON格式字符串转换为Python对象）

`json.loads(json_string)`

将JSON格式的字符串json_string转换为Python对象。

例如：

 json_str = '{"name": "张三", "age": 30, "city": "北京"}'
 data = json.loads(json_str)
 print(data)

输出：

 {'name': '张三', 'age': 30, 'city': '北京'}

这里data是一个字典对象。

`json.load(fp)`

从文件对象fp中读取JSON数据并转换为Python对象。例如：

 with open('data.json', 'r', encoding='utf-8') as f:
     data = json.load(f)
 print(data)

假设data.json文件内容是之前通过dump方法写入的JSON数据，这里读取后data也是一个字典对象。

三、Flask中的`jsonify`函数

jsonify是Flask框架提供的一个辅助函数，专门用于将Python对象转换为JSON格式的HTTP响应。与json.dumps()相比，jsonify更加简洁且易于使用，同时它还自动设置HTTP响应头的Content-Type为application/json，确保客户端能够正确解析返回的数据。

基本用法：

 from flask import jsonify, Flask
 app = Flask(__name__)
 
 @app.route('/index')
 def index():
     return jsonify({"home": "首页"})

特点：

自动设置响应头：jsonify会自动设置HTTP响应头的Content-Type为application/json，而json.dumps()需要手动设置。

压缩处理：jsonify会对返回的JSON数据进行压缩，减少数据传输量，提高效率。

简化代码：开发者无需手动封装响应对象，只需传递Python字典即可生成JSON格式的响应。

示例：

 @app.route('/users')
 def get_users():
     users = [
         {"id": 1, "name": "Alice"},
         {"id": 2, "name": "Bob"}
     ]
     return jsonify(users)

通过上述代码，Flask会自动将users列表转换为JSON格式的响应，并设置正确的响应头。