在开发小型游戏、答题应用或内部工具时，我们常常需要一个能随时变动的排行榜。相比引入数据库，直接用JSON文件来保存和加载数据更加轻量，也更容易调试。本文围绕如何用Python读写JSON文件，构建一个支持动态更新的排行榜系统展开，涵盖数据结构设计、保存逻辑、加载容错以及排序实现。
一、设计排行榜的数据结构
动态排行榜的本质是一个可变化的记录集合。为了兼顾可读性和扩展性，推荐使用列表嵌套字典的方式：列表的每一个元素代表一名用户，字典中至少包含用户名和分数两个字段，还可以加上更新时间。这样的结构在JSON中能自然映射为数组和对象，Python的json模块无需额外配置即可处理。
如果后期需要支持多榜单，也可以将最外层改为字典，用榜单名作为键，值为对应的记录列表。但在初版实现中，单一列表更简单，也方便直接对整个列表做排序和切片取前N名。下面是一个基础的数据示例，以及对应的Python变量定义方式。
# 排行榜内存中的结构
leaderboard = [
{"name": "张三", "score": 1500, "update": "2023-08-01 12:00"},
{"name": "李四", "score": 1800, "update": "2023-08-01 13:00"}
]
二、将排行榜保存为JSON文件
保存操作的核心是使用json.dump把内存对象写入文件。这里要注意打开文件时指定encoding='utf-8'，避免中文在Windows上变成乱码。另外，设置indent=2可让文件带缩进，方便人工查看和排查问题，虽然会稍微增大文件体积，但对小规模数据影响不大。
为了应对程序异常退出造成的写入中断，可以采用先写临时文件再重命名的方式。这样即使写一半崩溃，原JSON文件依然完好。下面的代码演示了带临时文件机制的保存函数，其中使用了os.replace保证操作的原子性。
import json
import os
def save_leaderboard(data, path="leaderboard.json"):
tmp = path + ".tmp"
with open(tmp, "w", encoding="utf-8") as f:
json.dump(data, f, ensure_ascii=False, indent=2)
os.replace(tmp, path)
# 调用示例
save_leaderboard(leaderboard)
这种做法的缺点是每次保存都要重写整个文件，当数据量达到几万条时会有性能瓶颈。但对于普通动态排行榜，条目通常不过千，重写成本可以忽略。若确实遇到大文件场景，可考虑只追加变更日志，定期合并。
三、从JSON文件加载并做容错
加载比保存更需要防御性编程。文件可能不存在、内容可能被用户手改坏、编码也可能不对。直接json.load若遇到格式错误会抛出JSONDecodeError，导致程序启动失败。因此要用try except包裹，并在异常时返回空列表或默认数据，让系统能自我恢复。
除了捕获解析异常，还应校验数据类型。例如确认读出来的是列表，且其中元素是带name和score的字典。分数最好转成int或float，防止文件中是字符串导致排序时报错。以下代码给出了一个健壮的加载函数。
import json
def load_leaderboard(path="leaderboard.json"):
try:
with open(path, "r", encoding="utf-8") as f:
data = json.load(f)
except (FileNotFoundError, json.JSONDecodeError):
return []
if not isinstance(data, list):
return []
cleaned = []
for item in data:
if isinstance(item, dict) and "name" in item and "score" in item:
item["score"] = float(item["score"])
cleaned.append(item)
return cleaned
# 调用示例
lb = load_leaderboard()
经过清洗的数据可以直接进入后续逻辑，不必在业务代码里反复判断。这种将脏数据拦截在边界处的做法，能让核心排序和展示代码更干净。
四、实现动态更新与排序
动态排行榜的重点是“动”：用户产生新分数后要实时插入或覆盖，并重新排序取前三名。如果同名用户再次提交，一般取最高分，这时可以先用字典按名字暂存最优成绩，再转回列表。排序用sorted配合key参数即可，reverse=True表示降序。
下面示例展示了如何合并新成绩、排序并截取前三人。注意在更新前先加载旧数据，否则每次保存都会丢失历史记录。这个流程串联起了加载、修改、保存三个环节，形成一个完整闭环。
def update_score(name, score, path="leaderboard.json", top=3):
lb = load_leaderboard(path)
# 用字典合并同名最高分
mapping = {row["name"]: row for row in lb}
if name in mapping:
mapping[name]["score"] = max(mapping[name]["score"], float(score))
else:
mapping[name] = {"name": name, "score": float(score), "update": "now"}
merged = list(mapping.values())
merged.sort(key=lambda x: x["score"], reverse=True)
top_list = merged[:top]
save_leaderboard(top_list, path)
return top_list
# 模拟一次更新
result = update_score("王五", 2000)
print(result)
上述实现把排行榜长度控制在top以内，适合只展示头部的情况。如果想保留全部记录只展示前几名，只需把切片移到展示层，保存时写merged即可。两种策略视产品需求而定，代码改动很小。
五、小结与注意事项
用JSON文件实现动态排行榜，优势是零依赖、易移植，特别适合原型期和单机工具。核心就是围绕json模块的dump和load，配合文件原子替换与异常捕获，就能写出稳健的保存加载逻辑。
需要提醒的是，多进程同时写同一个JSON文件会产生竞争，此时应加文件锁或改为数据库。另外，不要把敏感信息明文存JSON，若榜单含用户ID且要对外分发，至少做脱敏处理。掌握这些要点后，你可以轻松把这个模式套用到积分、战力、打卡天数等各类动态排序场景中。