Python字典与JSON字符串如何互转

今天我们来聊聊一个在Python面试中很常见的题目：Python字典与JSON字符串如何互转？ 如果你曾经经历过一些面试，或者是自己在编程过程中遇到过JSON数据，估计就会碰到这个问题。今天就来给大家好好捋一捋，教你如何在Python中轻松应对这个问题！💡

1. 字典与JSON字符串

首先，咱们得先了解两个基本概念：字典（dict）和JSON字符串。你可能已经知道，Python中的字典是一个非常常用的数据结构，像这样：

my_dict = {
    "name": "Alice",
    "age": 25,
    "city": "New York"
}

而JSON（JavaScript Object Notation）是一种轻量级的数据交换格式，通常以字符串的形式存储。JSON的数据结构与Python字典类似，不过它有一些小区别。比如，JSON中的键名必须用双引号（"），而Python字典的键可以用单引号或者双引号。

举个例子，Python字典与JSON字符串的对比：

Python字典：

my_dict = {
    'name': 'Alice',
    'age': 25,
    'city': 'New York'
}

JSON字符串：

{
    "name": "Alice",
    "age": 25,
    "city": "New York"
}

如果你把一个Python字典直接转换为JSON字符串，它的格式就像上面那样。

2. 如何实现字典和JSON字符串的转换？

现在咱们就进入正题了——如何实现Python字典和JSON字符串之间的互转？其实Python内置了json模块，专门用来处理JSON数据，它里面有两个非常有用的方法：**json.dumps()** 和 **json.loads()**。

2.1 字典转JSON字符串（json.dumps()）

如果你想将一个Python字典转换为JSON字符串，你可以使用 json.dumps() 方法。它的作用就是把Python对象（如字典、列表等）转化成JSON格式的字符串。看个例子：

import json
# Python字典
my_dict = {
    'name': 'Alice',
    'age': 25,
    'city': 'New York'
}
# 字典转JSON字符串
json_string = json.dumps(my_dict)
print(json_string)

输出结果：

{"name": "Alice", "age": 25, "city": "New York"}

解释：

• json.dumps()：这个方法把Python字典转换成JSON格式的字符串。如果字典中的数据类型不支持JSON表示（比如Python的set类型），它会抛出错误。
• 输出结果是一个标准的JSON字符串，注意这里的键名都被双引号包裹着。

2.2 JSON字符串转字典（json.loads()）

当你拿到一个JSON字符串，想把它转回Python字典时，使用 json.loads() 方法。这个方法将JSON格式的字符串解析成Python数据结构。

比如：

import json
# JSON字符串
json_string = '{"name": "Alice", "age": 25, "city": "New York"}'
# JSON字符串转Python字典
my_dict = json.loads(json_string)
print(my_dict)

输出结果：

{'name': 'Alice', 'age': 25, 'city': 'New York'}

解释：

• json.loads()：它的作用是将JSON字符串反向解析成Python对象。
• 这里我们把JSON字符串转回了字典格式，结果和原始字典几乎一样，除了它的键名是字符串类型。

3. 注意事项

虽然json.dumps() 和 json.loads() 很强大，但在实际操作中还是有几个坑需要注意：

3.1 字符编码问题

如果你要保存JSON字符串到文件，或者将其通过网络传输，通常需要指定字符编码。常见的编码是UTF-8。这里就需要使用ensure_ascii参数来保证你的字符编码正确。

import json
my_dict = {
    'name': 'Alice',
    'city': '北京'
}
# 字典转JSON字符串，确保输出的JSON中非ASCII字符可以正常显示
json_string = json.dumps(my_dict, ensure_ascii=False)
print(json_string)

输出：

{"name": "Alice", "city": "北京"}

解释：

• ensure_ascii=False：这个参数确保了输出JSON字符串中的中文字符不会被转义成Unicode编码，而是保持原样输出。

3.2 JSON字符串中包含多余的空格

你可能会发现，生成的JSON字符串中没有任何缩进，导致它很难阅读。如果你需要生成可读性更强的格式，可以使用indent参数来增加缩进。比如：

import json
my_dict = {
    'name': 'Alice',
    'age': 25,
    'city': 'New York'
}
# 带缩进的JSON字符串
json_string = json.dumps(my_dict, indent=4)
print(json_string)

输出：

{
    "name": "Alice",
    "age": 25,
    "city": "New York"
}

解释：

• indent=4：这个参数告诉Python在JSON字符串中每一层嵌套使用4个空格进行缩进。这样生成的JSON更加容易阅读，适合调试和日志记录。

3.3 JSON中没有Python的一些数据类型

有些Python的特殊数据类型是不能直接转换成JSON格式的。例如，set类型、complex类型就不能直接转换成JSON。如果你需要处理这些类型，可以通过自定义转换函数来解决这个问题。下面是一个例子：

import json
# 自定义函数来处理set类型
def custom_converter(obj):
    if isinstance(obj, set):
        return list(obj)  # 将set转换成list
    raise TypeError("Type not serializable")
my_set = {1, 2, 3, 4}
# 将set转为JSON字符串
json_string = json.dumps(my_set, default=custom_converter)
print(json_string)

输出：

[1, 2, 3, 4]

解释：

• default=custom_converter：通过指定default参数为自定义的转换函数，我们可以把Python的set类型转换为JSON支持的list类型。

4. 总结

今天我们聊了如何在Python中使用 json 模块进行字典与JSON字符串的互转。其实这不仅是面试题，还是开发中常见的场景。掌握这些基本方法，你在处理外部API接口数据、存储配置文件、序列化数据时都会得心应手！

总之，不管你是想把Python的字典转为JSON字符串，还是将JSON字符串转回字典，json.dumps() 和 json.loads() 都是你需要掌握的基本技能。而且，在实际使用中，记得注意字符编码、缩进和一些数据类型的特殊处理。这样，你就能避免那些常见的坑，轻松应对各种JSON相关的操作。

对编程、职场感兴趣的同学，大家可以联系我微信：golang404，拉你进入“程序员交流群”。

虎哥作为一名老码农，整理了全网最全《python高级架构师资料合集》。