如何为Pygame贪吃蛇游戏实现基于JSON的排行榜字典（存读）

一、Top5数据结构设计 #

不建议用{"1":0, "2":0...}这种独立键值对形式，更推荐用包含降序列表的字典，示例：

top5 = {"top_scores": [0, 0, 0, 0, 0]}

这种结构的优势是：列表天然支持排序、插入操作，后续更新分数时逻辑更简洁，无需单独处理每个排名的键。

二、JSON文件的核心原理 #

JSON是纯文本格式的轻量级数据存储方式，Python的json模块负责两个核心操作：

• json.dumps()/json.dump()：把Python的字典、列表等可序列化对象转换成JSON格式字符串，写入文件完成持久化（序列化）。
• json.loads()/json.load()：从JSON文件读取字符串，转换成Python可直接操作的字典/列表对象（反序列化）。
  简单来说就是实现内存数据和文件数据的双向转换，让游戏关闭后排行榜数据不会丢失。

三、完整实现步骤与代码 #

1. 游戏启动时加载排行榜 #

首次运行游戏时topfive.json不存在，需要创建默认排行榜；文件已存在则直接读取，用try-except处理异常：

import json

def load_top_scores():
    try:
        with open('topfive.json', 'r') as f:
            data = json.load(f)
            # 防止文件被篡改，确保数据结构合法
            if "top_scores" not in data or len(data["top_scores"]) != 5:
                return {"top_scores": [0, 0, 0, 0, 0]}
            return data
    except FileNotFoundError:
        # 文件不存在时生成默认排行榜并保存
        default_data = {"top_scores": [0, 0, 0, 0, 0]}
        save_top_scores(default_data)
        return default_data

2. 分数更新与保存逻辑 #

玩家结束游戏得到分数后，执行以下步骤自动更新排行榜：

1. 将新分数加入排行榜列表
2. 对列表降序排序（高分在前）
3. 截取前5个元素，自动淘汰最低分
4. 将更新后的排行榜写入文件

def update_top_scores(current_top, player_score):
    # 加入新分数
    current_top["top_scores"].append(player_score)
    # 降序排序
    current_top["top_scores"].sort(reverse=True)
    # 保留前5名
    current_top["top_scores"] = current_top["top_scores"][:5]
    # 保存到文件
    save_top_scores(current_top)
    return current_top

def save_top_scores(data):
    with open('topfive.json', 'w') as f:
        # indent=5让JSON文件格式更美观，方便手动查看
        json.dump(data, f, indent=5)

3. 游戏内调用示例 #

# 游戏启动时加载排行榜
top_scores = load_top_scores()

# 假设玩家结束游戏获得分数130
player_score = 130
# 更新排行榜
top_scores = update_top_scores(top_scores, player_score)

# 查看更新后的排行榜
print("当前Top5分数：", top_scores["top_scores"])

四、原代码的不足与优化 #

你原代码仅完成了默认文件的创建和读取，缺少分数更新逻辑和异常处理。上面的方案补上了核心功能，同时优化了数据结构，让后续维护更简单。

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