Python怎么将字典写入JSON文件_Python字典转JSON文件存储方法

Python字典转JSON文件广泛用于数据持久化、跨语言交换和配置管理，通过json.dump()直接写入文件或json.dumps()生成字符串再存储，结合ensure_ascii=False、indent格式化及default参数处理中文、美观输出与非标准类型，兼顾效率与可读性。

Python要把字典（dictionary）存成JSON文件，最直接也最常用的方法就是利用内置的

json

json.dump()

解决方案：

import json
import datetime

# 假设我们有一个Python字典
data = {
    "name": "张三",
    "age": 30,
    "isStudent": False,
    "courses": ["Math", "Science"],
    "address": {
        "street": "科技园路1号",
        "city": "深圳"
    },
    "grades": None,
    "last_updated": datetime.datetime.now().isoformat() # datetime对象需要特殊处理，这里先转成ISO格式字符串
}

# 方案一：直接写入文件
file_path_dump = "output_data_dump.json"
try:
    with open(file_path_dump, 'w', encoding='utf-8') as f:
        # indent参数让JSON文件更易读，ensure_ascii=False允许写入非ASCII字符（如中文）
        json.dump(data, f, indent=4, ensure_ascii=False)
    print(f"字典已成功写入到 {file_path_dump}")
except IOError as e:
    print(f"写入文件时发生IO错误: {e}")
except TypeError as e:
    print(f"字典序列化时发生类型错误: {e}")

# 方案二：先转换成JSON字符串，再写入文件（适用于需要先处理JSON字符串的场景）
json_string = ""
try:
    # indent参数同样用于格式化字符串，ensure_ascii=False处理非ASCII字符
    json_string = json.dumps(data, indent=4, ensure_ascii=False)
    print("\n转换后的JSON字符串:\n", json_string)
except TypeError as e:
    print(f"字典序列化为字符串时发生类型错误: {e}")

file_path_string = "output_data_string.json"
if json_string: # 只有成功生成字符串才写入
    try:
        with open(file_path_string, 'w', encoding='utf-8') as f:
            f.write(json_string)
        print(f"JSON字符串已成功写入到 {file_path_string}")
    except IOError as e:
        print(f"写入文件时发生IO错误: {e}")

Python字典转换为JSON文件在实际应用中扮演什么角色？

说实话，在现代软件开发里，Python字典转JSON文件这事儿简直是家常便饭，它的重要性怎么强调都不为过。我个人觉得，这主要体现在几个方面：数据持久化、跨语言数据交换，还有就是配置管理。

你想啊，我们程序跑起来，内存里那些活生生的数据，比如用户设置、程序状态、抓取下来的信息，总不能程序一关就全没了对吧？这时候就需要把它们“固化”下来。JSON以其简洁、人类可读的特点，成了非常理想的载体。用

json.dump()

立即学习“Python免费学习笔记（深入）”；

再说说跨语言数据交换。现在服务都是微服务架构，前端JavaScript、后端Python、Java，甚至移动端Swift、Kotlin，大家都要互相通信。JSON作为一种通用的、语言无关的数据格式，就成了那个“通用语”。Python字典序列化成JSON，前端可以直接解析，Java后端也能轻松反序列化成自己的对象。这种无缝衔接的能力，大大降低了不同技术栈之间协作的成本和复杂度。我曾经手头一个项目，需要Python脚本处理完数据后，把结果发给一个Node.js服务，JSON就是我们之间唯一的“桥梁”，效率很高。

最后还有配置管理。很多时候，我们不希望把所有配置都硬编码在代码里，而是希望通过一个外部文件来灵活调整。比如数据库连接信息、API密钥、各种开关参数。Python字典天生就能很好地表达这些键值对和嵌套结构，再一转成JSON文件，既方便人工编辑，也方便程序读取和更新。这比INI文件、XML文件，在表达复杂层级关系时，我觉得JSON更直观、更优雅。

json.dump()

登录后复制

与

json.dumps()

登录后复制

在文件存储场景下如何选择？

这俩函数，

json.dump()

json.dumps()

json.dump(obj, fp, ...)

fp

open()

json.dump()

而

json.dumps(obj, ...)

json.dumps()

Find JSON Path Online

Easily find JSON paths within JSON objects using our intuitive Json Path Finder

30

查看详情

举个例子，如果我有一个程序，它需要把处理结果存盘，同时也要通过HTTP POST请求把这个结果发送给另一个服务。那么，存盘我会用

json.dump()

json.dumps()

写入JSON文件时如何处理编码、格式化及非标准数据类型？

在将Python字典写入JSON文件时，编码、格式化和非标准数据类型是几个非常常见的“坑”，也是优化用户体验和程序健壮性的关键点。

首先是编码问题。默认情况下，

json

\uXXXX

\u4f60\u597d

json.dump()

json.dumps()

ensure_ascii=False

open()

encoding='utf-8'

ensure_ascii

其次是格式化。默认生成的JSON字符串或文件内容，可能都是紧凑的一行，没有换行和缩进，虽然机器读起来没问题，但人眼看起来就非常吃力。为了提高可读性，

json.dump()

json.dumps()

indent

indent=4

indent

最后，也是最容易让人头疼的，是非标准数据类型。JSON标准只支持字符串、数字、布尔值、

null

datetime

set

json

TypeError

1. 预处理数据：这是最直接的方式。在将字典传给

   json.dump()

   登录后复制
   之前，手动把那些非标准类型转换成JSON支持的类型。比如，

   datetime

   登录后复制
   对象可以转成ISO格式的字符串（

   datetime_obj.isoformat()

   登录后复制
   ），

   set

   登录后复制
   可以转成

   list

   登录后复制
   。上面的代码示例里，我就把

   datetime.datetime.now()

   登录后复制
   转成了字符串。

2. 使用

   default

   登录后复制
   参数：

   json.dump()

   登录后复制
   和

   json.dumps()

   登录后复制
   都有一个

   default

   登录后复制
   参数，可以指定一个函数。当序列化器遇到无法处理的对象时，就会调用这个函数。你可以在这个函数里定义如何将你的自定义对象转换成JSON可识别的格式。这对于处理自定义类实例特别有用。

   import json
   import datetime
   
   class MyCustomClass:
       def __init__(self, value):
           self.value = value
   
   def custom_serializer(obj):
       if isinstance(obj, datetime.datetime):
           return obj.isoformat()
       if isinstance(obj, MyCustomClass):
           return {"_MyCustomClass_": obj.value} # 转换成字典
       raise TypeError(f"Object of type {obj.__class__.__name__} is not JSON serializable")
   
   data_with_custom = {
       "timestamp": datetime.datetime.now(),
       "custom_obj": MyCustomClass("hello world")
   }
   
   # 使用default参数
   json_output = json.dumps(data_with_custom, indent=4, default=custom_serializer, ensure_ascii=False)
   print("\n处理自定义类型后的JSON:\n", json_output)

   登录后复制

   这个

   default

   登录后复制
   参数非常强大，它提供了一个钩子，让你能优雅地扩展

   json

   登录后复制
   模块的序列化能力。我建议，如果你经常需要序列化一些特定但非标准的对象，封装一个通用的

   default

   登录后复制
   函数会非常方便，避免每次都手动转换。

以上就是Python怎么将字典写入JSON文件_Python字典转JSON文件存储方法的详细内容，更多请关注php中文网其它相关文章！