如何逐行写入/追加字典列表至文件？尝试失败求技术建议

嘿，我来帮你搞定这两个需求！之前处理过类似的场景，知道怎么能让文件最终保持标准的字典列表格式，避免手动拼接字符串踩坑。

一、一次性将字典列表逐行写入文件 #

要实现这个需求，核心是保证文件最终是合法的JSON数组格式，同时让每个字典单独占一行（方便阅读）。直接用Python的json模块来处理是最稳妥的，能避免引号不匹配、逗号遗漏这类低级错误。

示例代码：

import json

# 你的字典列表
dict_list = [
    {"name": "Alice", "age": 30, "city": "New York"},
    {"name": "Bob", "age": 25, "city": "London"},
    {"name": "Charlie", "age": 35, "city": "Paris"}
]

with open("dict_list.json", "w", encoding="utf-8") as f:
    # 先写入数组开头的方括号
    f.write("[\n")
    # 遍历每个字典，逐个写入
    for idx, item in enumerate(dict_list):
        # 将字典转为格式化的JSON字符串
        json_str = json.dumps(item, indent=4)
        # 处理逗号：最后一个字典后面不加逗号
        if idx == len(dict_list) - 1:
            f.write(f"    {json_str}\n")
        else:
            f.write(f"    {json_str},\n")
    # 写入数组结尾的方括号
    f.write("]")

运行后，dict_list.json里的内容会是这样的（清晰易读，且是合法的JSON）：

[
    {
        "name": "Alice",
        "age": 30,
        "city": "New York"
    },
    {
        "name": "Bob",
        "age": 25,
        "city": "London"
    },
    {
        "name": "Charlie",
        "age": 35,
        "city": "Paris"
    }
]

二、逐行追加字典，最终形成字典列表 #

这个需求的难点在于：每次追加后要保证文件始终是合法的数组格式。这里分两种场景给你方案：

方案1：小文件场景（简单可靠）

如果文件数据量不大，直接读取整个数组、追加新字典、再重新写入是最不容易出错的方式：

import json

def append_dict_to_list(file_path, new_dict):
    try:
        # 读取现有文件中的字典列表
        with open(file_path, "r", encoding="utf-8") as f:
            existing_data = json.load(f)
    except FileNotFoundError:
        # 文件不存在时，初始化空列表
        existing_data = []
    
    # 追加新字典
    existing_data.append(new_dict)
    
    # 重新写入文件（格式化输出，方便阅读）
    with open(file_path, "w", encoding="utf-8") as f:
        json.dump(existing_data, f, indent=4)

# 测试追加
append_dict_to_list("append_data.json", {"name": "Dave", "age": 40, "city": "Tokyo"})
append_dict_to_list("append_data.json", {"name": "Eve", "age": 28, "city": "Sydney"})

方案2：大文件场景（高效追加）

如果文件很大，读取整个数组会占用过多内存，就需要直接操作文件指针，修改文件末尾的内容：

import json
import os

def append_dict_large_file(file_path, new_dict):
    new_dict_str = json.dumps(new_dict, indent=4)
    file_exists = os.path.exists(file_path)
    
    with open(file_path, "r+" if file_exists else "w", encoding="utf-8") as f:
        if not file_exists:
            # 第一次写入，直接创建数组
            f.write(f"[\n    {new_dict_str}\n]")
        else:
            # 将文件指针移到末尾，回退到最后一个"]"的位置
            f.seek(0, os.SEEK_END)
            # 回退2个字符：一个是换行符，一个是"]"（假设文件最后一行是"]"）
            f.seek(f.tell() - 2, os.SEEK_SET)
            # 写入逗号、新字典，再补回"]"
            f.write(f",\n    {new_dict_str}\n]")

# 测试高效追加
append_dict_large_file("large_append_data.json", {"name": "Frank", "age": 32, "city": "Berlin"})
append_dict_large_file("large_append_data.json", {"name": "Grace", "age": 27, "city": "Toronto"})

注意事项 #

• 尽量用json模块处理字典和字符串的转换，不要手动拼接，否则很容易出现JSON语法错误。
• 如果你的字典里有特殊字符（比如中文），记得打开文件时指定encoding="utf-8"，避免乱码。

内容的提问来源于stack exchange，提问作者Mauro Gentile