关于json.dumps中的参数，例如ensure_ascii

最新推荐文章于 2025-06-14 19:36:47 发布

凉凉Lxy

最新推荐文章于 2025-06-14 19:36:47 发布

阅读量3.2w

点赞数 12

CC 4.0 BY-SA版权

分类专栏： python 文章标签： python

本文链接：https://blog.youkuaiyun.com/liangxy2014/article/details/78985057

python 专栏收录该内容

18 篇文章

订阅专栏

本文详细介绍了Python中使用json.dumps方法进行JSON序列化的多种配置选项，包括如何调整输出格式以提高可读性，如何减少数据传输时的冗余，以及如何处理非字符串类型的键等问题。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

通过help(“json”) 看到里面有一个配置信息，

<span style="font-family:Microsoft YaHei;font-size:18px;">    
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)
</span>

编码后的json格式字符串紧凑的输出，而且也没有顺序，因此dumps方法提供了一些可选的参数，让输出的格式提高可读性。
（1）sort_keys是告诉编码器按照字典排序(a到z)输出。

import json

data = [ { 'a':'A', 'b':(2, 4), 'c':3.0 } ]
print 'DATA:', repr(data)

unsorted = json.dumps(data)
print 'JSON:', json.dumps(data)
print 'SORT:', json.dumps(data, sort_keys=True)
输出:

DATA: [{'a': 'A', 'c': 3.0, 'b': (2, 4)}]
JSON: [{"a": "A", "c": 3.0, "b": [2, 4]}]
SORT: [{"a": "A", "b": [2, 4], "c": 3.0}

（2）indent参数根据数据格式缩进显示，读起来更加清晰:

indent的数值，代表缩进的位数

import json

data = [ { 'a':'A', 'b':(2, 4), 'c':3.0 } ]
print 'DATA:', repr(data)

print 'NORMAL:', json.dumps(data, sort_keys=True)
print 'INDENT:', json.dumps(data, sort_keys=True, indent=2)
输出:

DATA: [{'a': 'A', 'c': 3.0, 'b': (2, 4)}]
NORMAL: [{"a": "A", "b": [2, 4], "c": 3.0}]
INDENT: [
  {
    "a": "A",
    "b": [
      2,
      4
    ],
    "c": 3.0
  }
]

(3)separators参数的作用是去掉,,:后面的空格，从上面的输出结果都能看到”, :”后面都有个空格，这都是为了美化输出结果的作用，但是在我们传输数据的过程中，越精简越好，冗余的东西全部去掉，因此就可以加上.

data = [ { 'a':'A', 'b':(2, 4), 'c':3.0 } ]
print 'DATA:', repr(data)
print 'repr(data)             :', len(repr(data))
print 'dumps(data)            :', len(json.dumps(data))
print 'dumps(data, indent=2)  :', len(json.dumps(data, indent=2))
print 'dumps(data, separators):', len(json.dumps(data, separators=(',',':')))
print json.dumps(data, sort_keys=True)
print json.dumps(data, sort_keys=True, separators=(',',':'))

输出结果为：

DATA: [{'a': 'A', 'c': 3.0, 'b': (2, 4)}]
repr(data)             : 35
dumps(data)            : 35
dumps(data, indent=2)  : 76
dumps(data, separators): 29
[{"a": "A", "b": [2, 4], "c": 3.0}]
[{"a":"A","b":[2,4],"c":3.0}]

(4)skipkeys参数，在encoding过程中，dict对象的key只可以是string对象，如果是其他类型，那么在编码过程中就会抛出ValueError的异常。skipkeys可以跳过那些非string对象当作key的处理.

data2 = [ { 'a':'A', 'b':(2, 4), 'c':3.0, ('d',):'D tuple' } ]
try:
    print json.dumps(data2)
except (TypeError, ValueError) as err:
    print 'ERROR:', err
print
print json.dumps(data2, skipkeys=True)

>>输出结果为：
>ERROR: keys must be a string

[{"a": "A", "c": 3.0, "b": [2, 4]}]

(5)输出真正的中文需要指定ensure_ascii=False

如果无任何配置，或者说使用默认配置，
输出的会是‘凉凉’的ASCII字符吗，而不是真正的中文。
这是因为json.dumps 序列化时对中文默认使用的ascii编码。

import json

print json.dumps('凉凉')

>> "\u51c9\u51c9"

想输出真正的中文需要指定ensure_ascii=False：

print json.dumps('凉凉', ensure_ascii=False)
>> 凉凉

参照：
http://liuzhijun.iteye.com/blog/1859857