Python 如何将 JSON 数据写入文件？

以下是 Python 将 JSON 数据写入文件的详细步骤和代码示例：

一、实现思路

1. 导入模块：使用 Python 的内置模块 json 来处理 JSON 数据。
2. 准备数据：创建或获取要写入文件的 JSON 数据，通常是 Python 的字典或列表对象。
3. 打开文件：使用 Python 的内置函数 open() 打开文件，通常使用 w 模式表示写入。
4. 写入数据：使用 json.dump() 函数将 Python 对象转换为 JSON 字符串并写入文件。

二、代码示例

import json


def write_json_file(file_path, data):
    try:
        with open(file_path, 'w') as file:
            json.dump(data, file, indent=4, ensure_ascii=False)
        print(f"数据已成功写入文件 {file_path}")
    except Exception as e:
        print(f"写入文件 {file_path} 时发生异常: {e}")


# 示例调用
if __name__ == "__main__":
    # 准备要写入的 JSON 数据，这里使用一个字典作为示例
    json_data = {
        "name": "李四",
        "age": 30,
        "hobbies": ["绘画", "音乐", "旅行"],
        "address": {
            "city": "上海",
            "street": "南京路",
            "zipcode": "200000"
        }
    }
    file_path = 'output.json'  # 替换为你自己的文件路径
    write_json_file(file_path, json_data)

代码解释

• 首先，我们导入了 json 模块，它提供了处理 JSON 数据的函数。
• write_json_file 函数接收两个参数：文件路径 file_path 和要写入的数据 data。
  • 使用 with open(file_path, 'w') as file 语句打开文件，这里使用 with 语句可以确保文件在使用完后自动关闭，避免资源泄漏。
  • 然后使用 json.dump(data, file, indent=4, ensure_ascii=False) 函数将 Python 对象 data 转换为 JSON 字符串并写入文件。
    • indent=4 参数使生成的 JSON 字符串具有缩进，更易读。
    • ensure_ascii=False 参数确保非 ASCII 字符（如中文）能正常显示，避免被转义。
  • 使用 try-except 语句捕获可能出现的异常，若发生异常将打印相应的错误信息。

三、使用示例

上述代码将生成一个名为 output.json 的文件，其内容如下：

{
    "name":"李四",
    "age":30,
    "hobbies":[
        "绘画",
        "音乐",
        "旅行"
    ],
    "address":{
        "city":"上海",
        "street":"南京路",
        "zipcode":"200000"
    }
}

四、注意事项

• 确保文件路径的正确性，文件所在的目录需要存在，如果目录不存在，可使用 os.makedirs() 函数创建目录。
• 注意文件的权限问题，如果文件是只读的，会导致写入失败。
• ensure_ascii=False 参数适用于包含非 ASCII 字符的情况，若数据中仅包含 ASCII 字符，可以不使用该参数。

通过以上方法，你可以方便地将 Python 对象转换为 JSON 字符串并写入文件。

你可以根据自己的实际需求修改文件路径和要写入的数据，灵活运用这个函数进行 JSON 文件的写入操作。

以下是一个更完整的示例，包括目录创建和文件权限处理：

import json
import os


def write_json_file(file_path, data):
    try:
        # 确保文件所在目录存在
        directory = os.path.dirname(file_path)
        if directory:
            os.makedirs(directory, exist_ok=True)
        with open(file_path, 'w') as file:
            json.dump(data, file, indent=4, ensure_ascii=False)
        print(f"数据已成功写入文件 {file_path}")
    except PermissionError:
        print(f"没有权限写入文件 {file_path}，请检查文件权限。")
    except Exception as e:
        print(f"写入文件 {file_path} 时发生异常: {e}")


# 示例调用
if __name__ == "__main__":
    # 准备要写入的 JSON 数据，这里使用一个字典作为示例
    json_data = {
        "name": "李四",
        "age": 30,
        "hobbies": ["绘画", "音乐", "旅行"],
        "address": {
            "city": "上海",
            "street": "南京路",
            "zipcode": "200000"
        }
    }
    file_path = 'output/output.json'  # 替换为你自己的文件路径
    write_json_file(file_path, json_data)

这个更完整的示例在写入文件之前会先确保文件所在目录存在，并且会处理文件权限问题。