本文讲解如何使用 Python 的 seek() 方法在单次文件操作中完成 JSON 写入与读取,避免因文件指针位置导致的解析错误,提升 I/O 效率与代码简洁性。
本文讲解如何使用 python 的 `seek()` 方法在单次文件操作中完成 json 写入与读取,避免因文件指针位置导致的解析错误,提升 i/o 效率与代码简洁性。
在 Python 中操作 JSON 文件时,一个常见误区是:写入后立即尝试读取,却遭遇 JSONDecodeError: Expecting value 错误。根本原因并非 JSON 格式问题,而是文件指针(cursor)的位置未重置。
当你调用 json.dump(data, file) 向文件写入内容后,文件指针会停留在写入数据的末尾。此时若直接调用 json.load(file),Python 会从当前指针位置(即文件末尾)开始读取——结果是读到空内容或无效字节,从而触发 JSON 解析失败。
✅ 正确做法是:在写入完成后,用 file.seek(0) 将指针移回文件开头,再执行读取:
Find JSON Path Online
Easily find JSON paths within JSON objects using our intuitive Json Path Finder
import json
passed_info = {
"Tom": 14,
"Sara": 12,
"Maureen": 2
}
# 推荐:使用 with 语句确保自动关闭,更安全
with open("data.json", "r+") as f:
json.dump(passed_info, f) # 写入 JSON(指针停在末尾)
f.seek(0) # 关键!将指针重置到文件开头
data = json.load(f) # 此时可正确读取整个 JSON 对象
print(data)
# 输出: {'Tom': 14, 'Sara': 12, 'Maureen': 2}
⚠️ 注意事项:
- 必须使用 "r+" 模式(可读可写),不可用 "w+" —— 因为 "w+" 会清空原有文件内容,即使你只写入一次;
- seek(0) 是必需步骤,不可省略;若需读取部分数据,还可配合 seek(n) 定位到指定字节;
- 若原 JSON 文件非空,且新数据比旧数据短(例如原文件有 100 字节,新数据仅 50 字节),则文件末尾可能残留旧字符(如 } 后的冗余内容),导致后续读取异常。此时建议先截断:f.truncate()(放在 seek(0) 之后、json.load() 之前)以清除多余字节:
with open("data.json", "r+") as f:
json.dump(passed_info, f)
f.seek(0)
f.truncate() # 确保文件长度精确匹配新内容
data = json.load(f)
? 总结:无需反复打开/关闭文件。掌握 seek() 和 truncate(),配合 with 上下文管理,即可在一个 open() 调用中安全、高效地完成“覆盖写入 + 即时读取”全流程——这是处理配置文件、缓存数据等场景的推荐实践。