如何把字典类型转换成json

如何将字典类型转换为JSON格式：从基础到实践

在Python开发中,字典（dict）和JSON（JavaScript Object Notation）都是常用的数据结构，字典是Python内置的键值对集合，而JSON是一种轻量级的数据交换格式，广泛用于前后端数据交互、配置文件存储等场景，将字典转换为JSON，本质上是将Python的字典对象序列化为符合JSON标准的字符串，本文将详细介绍字典转JSON的方法、常见问题及解决方案，帮助开发者这一实用技能。

为什么需要将字典转换为JSON？

Python字典虽然灵活,但存在一些局限性：

跨语言兼容性：字典是Python特有的数据结构，其他语言（如JavaScript、Java）无法直接解析；而JSON是通用格式，几乎所有编程语言都支持。
数据存储：字典无法直接写入文本文件或数据库，而JSON字符串可以轻松存储为文本或传输到远程服务器。
API交互：现代Web API普遍使用JSON作为数据交换格式，后端需将Python数据（如字典）转换为JSON才能与前端通信。

核心方法：使用`json`模块进行序列化

Python内置的json模块提供了json.dumps()方法（dumps = dump string），专门用于将Python对象（包括字典）转换为JSON字符串，其基本语法如下：

import json
json_str = json.dumps(dict_obj)

基础示例：简单字典转JSON

假设有一个简单的字典,包含基本数据类型（字符串、数字、布尔值、None），转换过程如下：

import json
# 定义一个字典
user_info = {
    "name": "张三",
    "age": 25,
    "is_student": False,
    "scores": [85, 90, 78],
    "address": None
}
# 转换为JSON字符串
json_str = json.dumps(user_info)
print(json_str)
# 输出：{"name": "张三", "age": 25, "is_student": false, "scores": [85, 90, 78], "address": null}

注意：

Python中的True/False会被转换为JSON的true/false（全小写）；
Python中的None会被转换为JSON的null；
字典的键（key）必须是字符串类型（或能被转换为字符串的类型，如数字），否则会报错。

处理中文字符：解决“乱码”问题

默认情况下,json.dumps()会将非ASCII字符（如中文）转义为Unicode编码（如\u5f20\u4e09），导致输出可读性差，通过ensure_ascii=False参数，可以保留原始字符：

import json
user_info = {"name": "张三", "city": "北京"}
# 默认（ASCII转义）
json_str_ascii = json.dumps(user_info)
print(json_str_ascii)
# 输出：{"name": "\u5f20\u4e09", "city": "\u5317\u4eac"}
# 保留中文（ensure_ascii=False）
json_str_chinese = json.dumps(user_info, ensure_ascii=False)
print(json_str_chinese)
# 输出：{"name": "张三", "city": "北京"}

推荐：在与中文相关的场景中，始终使用ensure_ascii=False，以提升数据可读性。

格式化输出：美化JSON字符串

默认情况下,json.dumps()输出的JSON字符串是紧凑的（无缩进和换行），若需格式化输出（如调试或配置文件场景），可通过indent参数指定缩进空格数：

import json
data = {
    "name": "李四",
    "hobbies": ["reading", "swimming"],
    "contact": {
        "email": "lisi@example.com",
        "phone": "13800138000"
    }
}
# 紧凑格式（默认）
json_str_compact = json.dumps(data)
print(json_str_compact)
# 输出：{"name": "李四", "hobbies": ["reading", "swimming"], "contact": {"email": "lisi@example.com", "phone": "13800138000"}}
# 美化格式（缩进4空格）
json_str_pretty = json.dumps(data, indent=4, ensure_ascii=False)
print(json_str_pretty)
# 输出：
# {
#     "name": "李四",
#     "hobbies": [
#         "reading",
#         "swimming"
#     ],
#     "contact": {
#         "email": "lisi@example.com",
#         "phone": "13800138000"
#     }
# }

处理特殊数据类型：自定义序列化

Python字典中可能包含JSON不直接支持的数据类型（如datetime、自定义类对象），直接使用json.dumps()会抛出TypeError。

import json
from datetime import datetime
data = {"time": datetime.now()}
try:
    json_str = json.dumps(data)
except TypeError as e:
    print(f"错误：{e}")  # 错误：Object of type datetime is not JSON serializable

解决方案：通过default参数传入自定义序列化函数，将特殊类型转换为JSON支持的类型。

示例1：处理`datetime`对象

import json
from datetime import datetime
def datetime_serializer(obj):
    if isinstance(obj, datetime):
        return obj.isoformat()  # 转换为ISO格式字符串（如"2023-10-01 12:00:00"）
    raise TypeError(f"Object of type {type(obj)} is not JSON serializable")
data = {"time": datetime.now()}
json_str = json.dumps(data, default=datetime_serializer, ensure_ascii=False)
print(json_str)
# 输出：{"time": "2023-10-01 15:30:45.123456"}

示例2：处理自定义类对象

import json
class User:
    def __init__(self, name, age):
        self.name = name
        self.age = age
def user_serializer(obj):
    if isinstance(obj, User):
        return {"name": obj.name, "age": obj.age}  # 转换为字典
    raise TypeError(f"Object of type {type(obj)} is not JSON serializable")
user = User("王五", 30)
json_str = json.dumps(user, default=user_serializer, ensure_ascii=False)
print(json_str)
# 输出：{"name": "王五", "age": 30}

将JSON字符串写入文件：`json.dump()`方法

若需将字典直接转换为JSON并写入文件（而非生成字符串），可使用json.dump()方法（dump = dump to file），其基本语法如下：

import json
data = {"name": "赵六", "score": 95}
# 写入文件（默认覆盖模式）
with open("user.json", "w", encoding="utf-8") as f:
    json.dump(data, f, ensure_ascii=False, indent=4)

执行后,user.json为：

{
    "name": "赵六",
    "score": 95
}

注意：

文件打开模式需为写入模式（如"w"、"w+"）；
建议始终指定encoding="utf-8"，避免编码问题；
若需追加内容,可使用"a"模式（但JSON文件通常以完整对象为单位，追加可能导致格式错误）。

常见问题与解决方案

问题：`TypeError: Object of type int64 is not JSON serializable`

原因：字典中包含numpy的int64等类型，JSON不支持。
解决：在default参数中将其转换为Python原生int：

import json
import numpy as np
def numpy_serializer(obj):
    if isinstance(obj, (np.int64, np.int32)):
        return int(obj)
    raise TypeError
data = {"value": np.int64(42)}
json_str = json.dumps(data, default=numpy_serializer)
print(json_str)  # 输出：{"value": 42}

问题：JSON键被排序（非原始顺序）

原因：json.dumps()默认对字典键进行排序（按ASCII码顺序）。
解决：通过sort_keys=False参数保留原始键顺序（Python 3.7+字典默认保留插入顺序）：

import json
data = {"b": 2, "a": 1, "c": 3}
json_str_sorted = json.dumps(data, sort_keys=True)  # 排序
print(json_str_sorted)  # 输出：{"a": 1, "b": 2, "c": 3}
json_str

正文