Python向JSON文件追加列表异常：原因分析及修复方法

嘿，我来帮你揪出这个问题的根源！向JSON文件里的列表追加新名称却达不到预期，大概率是踩了这几个常见的坑，我给你一一拆解并附上修复方案：

原因1：错误使用文件模式，破坏JSON结构或覆盖原有内容 #

很多新手会误以为可以像操作普通文本文件那样，用'a'（追加）模式直接把新元素写入JSON文件，或者用'w'（写入）模式但没先读取原有数据就直接写新内容——这两种操作都会出问题：

• 用'a'模式写入：会把新元素以字符串形式直接追加到文件末尾，彻底破坏JSON的结构化格式（比如原来的["Bob","Charlie"]会变成["Bob","Charlie"]"Alice"，完全无法被JSON解析）。
• 用'w'模式但不读原有数据：会直接清空文件，把新元素单独写进去，覆盖掉原来的列表。

修复代码示例 #

先读取原有JSON数据，解析成Python列表，追加新元素后再完整写入文件：

import json

new_name = "Alice"

# 处理文件不存在的情况，初始化空列表
try:
    with open('names.json', 'r') as f:
        names = json.load(f)
    # 确保读取到的是列表（防止原有文件存的不是列表）
    if not isinstance(names, list):
        names = []
except FileNotFoundError:
    names = []

# 追加新名称
names.append(new_name)

# 重新写入整个更新后的列表
with open('names.json', 'w') as f:
    json.dump(names, f, indent=4)  # indent参数让JSON格式更易读

原因2：原有JSON文件格式损坏或存储的不是列表 #

如果之前的操作已经把JSON文件搞坏了（比如格式错误），或者文件里存储的根本不是列表（比如是字典或单个字符串），那么json.load()会解析失败，要是没做异常处理，程序可能直接报错，或者初始化空列表后写入，导致你以为“追加失败”。

修复代码示例 #

加上JSON解析异常处理，同时校验数据类型：

import json

new_name = "Alice"

try:
    with open('names.json', 'r') as f:
        try:
            names = json.load(f)
        except json.JSONDecodeError:
            print("警告：原有JSON文件格式损坏，将初始化空列表")
            names = []
    # 校验是否为列表类型
    if not isinstance(names, list):
        print("警告：JSON文件中存储的不是列表，将初始化空列表")
        names = []
except FileNotFoundError:
    names = []

names.append(new_name)

with open('names.json', 'w') as f:
    json.dump(names, f, indent=4)

原因3：多线程/多进程并发写入导致数据冲突 #

如果有多个程序或线程同时读写这个JSON文件，可能会出现一个写入操作还没完成，另一个就开始写入的情况，最终导致文件内容混乱、数据丢失。

修复代码示例 #

使用文件锁来保证同一时间只有一个进程/线程操作文件（需要先安装filelock库：pip install filelock）：

from filelock import FileLock
import json

new_name = "Alice"
lock_file = "names.json.lock"  # 锁文件路径

with FileLock(lock_file):
    try:
        with open('names.json', 'r') as f:
            names = json.load(f)
        if not isinstance(names, list):
            names = []
    except FileNotFoundError:
        names = []
    
    names.append(new_name)
    
    with open('names.json', 'w') as f:
        json.dump(names, f, indent=4)

内容的提问来源于stack exchange，提问作者J. Jesper