基本用法

json.dump（obj, fp, *, skipkeys=False, ensure_ascii=True, check_circular=True, allow_nan=True, cls=None, indent=None, separators=None, default=None, sort_keys=False, **kw）

序列化obj作为JSON格式化的流到fp（.write() – 支持类文件对象）使用这个转换表.

如果skipkeys为真（默认值：False），那么dict键不是基本类型（str, int, float, bool,None）将跳过而不是提出TypeError.

json模块总是产生str对象，而不是bytes对象。因此，fp.write()必须支持str输入

如果ensure_ascii为真（默认值），输出保证所有传入的非ASCII字符都被转义。如果ensure_ascii为false，这些字符将输出as-is.

如果check_circular为false（默认值：True），则对容器进行循环引用检查类型将被跳过，循环引用将导致OverflowError（或更糟）.

如果allow_nan为假（默认：True），那么它将ValueError严格按照JSON规范序列化超出范围float values（nan,inf, -inf）。如果allow_nan为真，则其JavaScript等效（NaN,Infinity, -Infinity）将被使用

如果indent是一个非负整数或字符串，然后JSON数组元素和对象成员将使用该缩进级别进行漂亮打印。缩进级别0，负数或""仅插入换行符。None（默认值）选择最紧凑的表示。使用正整数缩进，每个级别有很多空格。如果indent是一个字符串（例如"\t"），该字符串用于缩进每个级别.

更改版本3.2：除了整数之外还允许indent的字符串.

如果指定的话，separators应该是(item_separator, key_separator)元组。默认是(", ", ": ")如果indent是None和(",", ": ")除此以外。要获得最紧凑的JSON表示，您应该指定(",", ":")消除空白.

版本3.4更改：使用 (",", ": ")如果indent不是None.

如果指定，default应该是一个被调用的对象，否则无法序列化。它应该返回一个JSON可编码的对象版本或者TypeError。如果没有指定，则TypeError被引发

如果sort_keys为真（默认：False），那么输出的数据将按键排序.

使用自定义JSONEncoder子类（例如覆盖default()序列化其他类型的方法），用cls kwarg指定;否则JSONEncoder使用.

更改版本3.6：所有可选参数现在仅限关键字.

注意

与pickle和marshal不同，JSON不是一个框架协议，因此尝试使用相同的dump()重复调用fp来序列化多个对象将导致一个无效的JSON文件.

json.dumps (obj, *, skipkeys=False, ensure_ascii=True, check_circular=True, allow_nan=True, cls=None, indent=None, separators=None, default=None, sort_keys=False, **kw )

序列化obj到JSON格式str使用这个转换表。参数与中的含义相同dump().

注意

JSON的键/值对中的键总是str。当字典转换为JSON时，字典的所有键都被转换为字符串。因此，如果将字典转换为JSON然后再转换为字典，则字典可能与原始字典不同。也就是说，loads(dumps(x)) != x如果x有nonstringkeys.

json.load (fp, *, cls=None, object_hook=None, parse_float=None, parse_int=None, parse_constant=None, object_pairs_hook=None, **kw)

Deserialize fp（a .read()支持文本文件或包含JSON文档的二进制文件使用这个转换表到Python对象.

object_hook是一个可选函数，将被调用任何对象文字的结果（dict）。将使用object_hook的返回值代替dict。此功能可用于实现自定义解码器（例如JSON-RPCclass提示）.

object_pairs_hook是一个可选函数，将使用有序对列表解码的任何对象文字的结果调用。将使用object_pairs_hook的值来代替dict。此功能可用于实现自定义解码器。如果object_hook也定义，object_pairs_hook优先级.

更改版本3.1：添加对object_pairs_hook.

parse_float的支持，如果指定，将使用要解码的每个JSONfloat的字符串调用。默认情况下，这相当于float(num_str)。这可以用来为JSON浮点数使用另一种数据类型或解析器（例如decimal.Decimal).

parse_int如果指定，将使用每个要解码的JSON的字符串调用。默认情况下，这相当于int(num_str)。这可以用于为JSON整数使用另一种数据类型或解析器（例如float）.

parse_constant，如果指定，将使用以下一个字符串调用："-Infinity", "Infinity", "NaN"。如果遇到无效的JSON号码，这可用于引发异常.

改变版本3.1：parse_constant不再调用’null’，’true’，’false’。

使用自定义的JSONDecoder子类，用cls kwarg指定它;除此以外 JSONDecoder用来。其他关键字参数将被传递给类的构造函数.

如果被反序列化的数据不是有效的JSON文档，则JSONDecodeError将被引发

在版本3.6中更改：所有可选参数现在都是仅限关键字.

在版本3.6中更改：fp现在可以是二进制文件。输入编码应为UTF-8，UTF-16或UTF-32.

json.loads (s, *, encoding=None, cls=None, object_hook=None, parse_float=None, parse_int=None, parse_constant=None, object_pairs_hook=None, **kw)

Deserialize s（a str, bytes或bytearray包含JSON文档的实例）使用这个转换表.

其他参数与load()中的含义相同，除了encoding被忽略和弃用.

如果被反序列化的数据不是有效的JSON文档，// JSONDecodeError会被举起来

版本3.6更改：s现在可以是bytes要么 bytearray。输入编码应为UTF-8，UTF-16或UTF-32 .

编码器和解码器

class json.JSONDecoder（*, object_hook=None, parse_float=None, parse_int=None, parse_constant=None, strict=True, object_pairs_hook=None）

简单的JSON解码器

默认情况下在解码时执行以下翻译：

JSON	Python
object	dict
array	list
string	str
number（int）	int
number（real）	浮
真正	真
假	假
null	没有

它也理解NaN, Infinity和-Infinity作为对应的float值，这超出了JSON规范

object_hook，如果指定，将调用每个JSONobject解码的结果，并使用其返回值代替给定的dict。这可用于提供自定义反序列化（例如，支持JSON-RPC类提示）.

object_pairs_hook，如果指定将使用有序的对列表对解析的everyJSON对象的结果进行调用。将使用object_pairs_hook的返回值代替dict。此功能可用于实现自定义解码器。如果object_hook是alsodefined，则object_pairs_hook优先.

在版本3.1中更改：添加对object_pairs_hook.

parse_float的支持，如果指定，将使用要解码的每个JSONfloat的字符串调用。默认情况下，这相当于float(num_str)。这可以用来为JSON浮点数使用另一种数据类型或解析器（例如decimal.Decimal).

parse_int如果指定，将使用每个要解码的JSON的字符串调用。默认情况下，这相当于int(num_str)。这可以用来为JSON整数使用另一个数据类型或解析器（例如float).

parse_constant，如果指定，将使用以下一个字符串调用："-Infinity", "Infinity", "NaN"。这可以如果遇到无效的JSON号，则用于引发异常.

如果strict为false（True是默认值），则控制字符将被允许在字符串内。此上下文中的控制字符包含0-31范围内的字符代码，包括"\t"（tab），"\n", "\r"和"\0".

如果要反序列化的数据不是有效的JSON文件，一个JSONDecodeError将被抬起.

在版本3.6中更改：现在所有参数都是仅关键字.

decode（s）

返回s的Python表示（str包含JSON文档的实例）.

JSONDecodeError如果给定的话会被提出JSON文件无效.

raw_decode(s)

从s（str从aJSON文档开始）并返回Python表示的2元组和s中文档结束的索引.

这可以用于从可能具有extraneous的字符串中解码JSON文档最后的数据.

class json.JSONEncoder(*, skipkeys=False, ensure_ascii=True, check_circular=True, allow_nan=True, sort_keys=False, indent=None, separators=None, default=None)

用于Python数据结构的可扩展JSON编码器.

默认支持以下对象和类型：

Python	JSON
dict	object
list，tuple	array
str	string
int，float，int-＆amp;float-derived Enums	number
True	true
False	false
没有	null

在版本3.4中更改：添加了对int和float派生的Enum类的支持.

扩展它以识别其他对象，子类并实现一个default()方法用另一个方法返回一个可序列化的对象o如果可能的话，否则它应该调用超类实现（提升TypeError).

如果skipkeys是假的（默认），那就是TypeError尝试编码不是str, int,float或None的密钥。如果skipkeys为真，那么这些项目就是简单的.

如果ensure_ascii为真（默认值），输出将保证所有传入的非ASCII字符都被转义。如果ensure_ascii是错误的，这些字符将输出as-is.

如果check_circular为true（默认值），则将检查列表，dicts和customencoded对象编码过程中的循环引用可以防止无限递归（这会导致OverflowError）。否则，不会发生这样的检查.

如果allow_nan为真（默认值），那么NaN, Infinity和-Infinity将被编码。此行为不符合JSON规范，但与大多数JavaScript basedencoders和解码器一致。否则，ValueError会对这些浮点数进行编码

如果sort_keys为真（默认：False），那么字典的输出将按以下顺序排序键;这对于回归测试很有用，可以确保日常比较JSON序列化.

如果indent是一个非负整数或字符串，然后JSON数组元素和对象成员将使用该缩进级别进行漂亮打印。缩进级别0，负数或""仅插入换行符。None（默认值）选择最紧凑的表示。使用正整数缩进，每个级别有很多空格。如果indent是一个字符串（例如"\t"），该字符串用于缩进每个级别.

更改版本3.2：除了整数之外还允许indent的字符串.

如果指定的话，separators应该是(item_separator, key_separator)元组。默认是(", ", ": ")如果indent是None和(",", ": ")除此以外。要获得最紧凑的JSON表示，您应该指定(",", ":")消除空白.

版本3.4更改：使用 (",", ": ")如果indent不是None.

如果指定，default应该是一个被调用的对象，否则无法序列化。它应该返回一个JSON可编码的对象版本或者TypeError。如果没有指定，则TypeError被提升.

更改版本3.6：所有参数现在都是 keyword-only .

default（o）

在子类中实现此方法，使其返回o的serializable对象，或调用基本实现（以提升TypeError).

例如，为了支持任意迭代器，你可以实现defaultlike：

def default(self, o):   try:       iterable = iter(o)   except TypeError:       pass   else:       return list(iterable)   # Let the base class default method raise the TypeError   return json.JSONEncoder.default(self, o)

encode（o）

返回一个Python数据结构的JSON字符串表示，o。例如：

>>> json.JSONEncoder().encode({"foo": ["bar", "baz"]})"{"foo": ["bar", "baz"]}"

iterencode（o）

对给定对象进行编码，o，并将每个字符串表示形式为可用。例如：

for chunk in json.JSONEncoder().iterencode(bigobject):    mysocket.write(chunk)

异常

exception json.JSONDecodeError（msg, doc, pos）

ValueError的子类，具有以下附加属性：

msg

未格式化的错误消息.

doc

正在解析的JSON文档.

pos

的起始索引doc解析失败的地方.

lineno

对应pos.

colno

对应于的列pos.

版本3.5中的新功能.

标准兼容性和互操作性

JSON格式由 RFC 7159 通过ECMA-404。本节详细介绍了该模块与RFC的兼容程度。为简单起见，JSONEncoder和JSONDecoder除了那些明确提到的参数之外，不考虑子类和参数.

此模块不严格遵守RFC，实现了一些有效JavaScript但不是有效JSON的扩展。特别是：

• 接受并输出无限和NaN数值;
• 接受对象中的重复名称，并且仅使用lastname-value对的值.

由于RFC允许符合RFC的解析器接受不符合RFC的输入文本，因此该模块的解串器在技术上符合RFC的默认设置.

>>> # Neither of these calls raises an exception, but the results are not valid JSON>>> json.dumps(float("-inf"))"-Infinity">>> json.dumps(float("nan"))"NaN">>> # Same when deserializing>>> json.loads("-Infinity")-inf>>> json.loads("NaN")nan

>>> weird_json = "{"x": 1, "x": 2, "x": 3}">>> json.loads(weird_json){"x": 3}

命令行界面

时，这尤其相关源代码： Lib / json / tool.py

json.tool模块提供了一个简单的命令行界面来验证和漂亮打印JSON对象.

如果是可选的infile和outfile参数未指定，sys.stdin和sys.stdout将分别使用：

$ echo "{"json": "obj"}" | python -m json.tool{    "json": "obj"}$ echo "{1.2:3.4}" | python -m json.toolExpecting property name enclosed in double quotes: line 1 column 2 (char 1)