在 Python 中，`json.dump()` 方法用于将 JSON 数据写入文件。该方法属于标准库 `json` 模块的一部分，允许将 Python 对象（如字典或列表）序列化为 JSON 格式，并保存到磁盘中。 ### 使用 json.dump() 的基本步骤 1. **导入 json 模块** 在代码中首先需要导入 `json` 模块以使用其功能[^2]。 2. **打开文件进行写入** 使用 `with open(..., 'w') as wf:` 语法打开一个文件，确保在操作完成后自动关闭文件流。 3. **调用 json.dump()** 将数据和文件对象传递给 `json.dump(data, file_object)`，其中 `data` 是要序列化的 Python 对象，`file_object` 是已打开的文件句柄。 以下是一个完整的示例： ```python import json # 定义一个 Python 列表 numbers = [1, 2, 3, 4, 5] # 文件名 filename = 'numbers.json' # 写入 JSON 文件 with open(filename, 'w') as wf: json.dump(numbers, wf) ``` ### 参数说明 - **ensure_ascii**: 默认为 `True`，会将非 ASCII 字符转义为 Unicode 编码。设置为 `False` 可保留中文字符。 - **indent**: 控制缩进格式，通常设为 4 或 2，使输出的 JSON 文件更易读。 例如，美化输出格式： ```python import json data = { "name": "Alice", "age": 30, "city": "Wonderland" } with open('pretty_data.json', 'w', encoding='utf-8') as f: json.dump(data, f, indent=4, ensure_ascii=False) ``` ### 注意事项 - `json.dump()` 不会自动添加换行符，如果需要，可以在写入后手动添加。 - 如果目标文件不存在，`open()` 函数将以写入模式创建新文件；若文件已存在，则会覆盖原有内容。 ### 异常处理 为了防止因文件路径错误、权限问题等导致程序崩溃，建议使用异常处理机制捕获潜在错误[^2]。 ```python try: with open('numbers.json', 'w') as wf: json.dump(numbers, wf) except IOError as e: print(f"An error occurred: {e}") ``` ### 扩展：美化 JSON 输出 可以通过第三方库 `prettyjson` 提供的 `dumps()` 方法来美化 JSON 输出，使得结构更加清晰可读[^3]。 ```python from prettyjson import dumps print(dumps(data, indent=4)) ```