如何使用循环向JSON文件追加数据？解决JSONDecodeError报错

触发json.decoder.JSONDecodeError: Expecting value: line 1 column 1 (char 0)以及代码无法正常运行的根源有三个：

• 文件打开模式使用错误：a+是追加读写模式，打开后文件指针默认停在文件末尾，直接调用json.load()时读取的是指针后的空内容，自然触发解析错误。就算把代码里的file.seek(0)移到读操作之前，剩余两个问题依然会导致运行失败。
• 文件初始内容不符合JSON规范：当前sample_file.json里存储的12345不是可做键值更新的合法JSON结构——如果要调用字典的update方法，JSON根节点必须是对象结构（对应Python字典，初始合法内容应为{}），纯数字解析后是整数类型，既不满足结构化存储要求，也不存在update方法。
• 方法传参不符合要求：dict.update()要求传入参数为字典或者可迭代的键值对结构，直接传入循环生成的整数i会触发类型错误。

JSON是整体结构化存储格式，和可逐行追加的日志类文本不同，直接在文件末尾追加内容会破坏整体结构合法性，导致整个文件无法解析。正确操作流程固定为：读取全量文件内容→解析为Python内存对象→在内存中修改对象→用覆盖模式把修改后的全量对象序列化写回文件。
操作前先把sample_file.json的初始内容改成合法JSON：如果要存键值对就写{}，如果要存条目列表就写[]。

如果需求是循环往JSON对象中添加键值对，参考代码如下：

import json

# 首次运行初始化文件用，已经存在合法JSON文件可注释
# with open("sample_file.json", "w") as f:
#     json.dump({}, f)

for i in range(10):
    # 读模式加载全量数据
    with open("sample_file.json", "r") as file:
        data = json.load(file)
    # 按自己的业务需求更新字典，这里示例key为序号、值为i
    data.update({f"key_{i}": i})
    # 覆盖写回更新后的数据
    with open("sample_file.json", "w") as file:
        json.dump(data, file, indent=2, ensure_ascii=False)

如果需求是循环往JSON数组中追加条目，先把文件初始内容改为[]，参考代码如下：

import json

# 首次运行初始化文件用，已经存在合法JSON文件可注释
# with open("sample_file.json", "w") as f:
#     json.dump([], f)

for i in range(10):
    with open("sample_file.json", "r") as file:
        data = json.load(file)
    # 往数组追加元素
    data.append(i)
    with open("sample_file.json", "w") as file:
        json.dump(data, file, indent=2, ensure_ascii=False)

注意：如果单JSON文件存储的数据量超过百MB级别，每次全量读写的性能会很差，这种场景不适合用普通JSON做增量存储，建议替换为SQLite等轻量数据库，或者采用JSON Lines格式（每行存储一个独立JSON对象）做增量写入。

内容的提问来源于stack exchange，提问作者chumba mumbau