如何在不重复打开关闭的情况下编辑并读取 JSON 文件(Python 教程)

2026-06-03日常编程223077

本文讲解如何使用 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() 调用中安全、高效地完成“覆盖写入 + 即时读取”全流程——这是处理配置文件、缓存数据等场景的推荐实践。

本文地址:https://www.ufcn.cn/tutorials/3428647.html

如非特殊说明,本站内容均来自于网友自主分享,概不代表本站观点,如有任何问题我们都将在收到反馈后的第一时间进行处理!