保存 JSON 配置时,为什么可以先写临时文件再替换?

举报
yd_259541464 发表于 2026/11/10 11:13:15 2026/11/10
【摘要】 程序直接用 open(path, "w") 保存配置时,打开文件就会先清空原内容。如果序列化失败或写入中断,原来能用的配置可能只剩空文件或半截内容。一种常见做法是在目标文件所在目录先写一个临时文件,写完并关闭后,再用 os.replace() 替换目标文件。读取者重新打开目标路径时,可以读到替换前的旧内容或替换后的完整新内容。import jsonimport osimport tempfi...

程序直接用 open(path, "w") 保存配置时,打开文件就会先清空原内容。如果序列化失败或写入中断,原来能用的配置可能只剩空文件或半截内容。

一种常见做法是在目标文件所在目录先写一个临时文件,写完并关闭后,再用 os.replace() 替换目标文件。读取者重新打开目标路径时,可以读到替换前的旧内容或替换后的完整新内容。

import json
import os
import tempfile
from pathlib import Path


def save_json(path, data):
    path = Path(path)
    temporary = None
    try:
        with tempfile.NamedTemporaryFile(
            mode="w", encoding="utf-8", dir=path.parent,
            prefix=f".{path.name}.", suffix=".tmp", delete=False
        ) as output:
            temporary = Path(output.name)
            json.dump(data, output, ensure_ascii=False, indent=2)
            output.write("\n")
            output.flush()
            os.fsync(output.fileno())

        os.replace(temporary, path)
        temporary = None
    finally:
        if temporary is not None:
            temporary.unlink(missing_ok=True)

用法例如:

save_json("settings.json", {"theme": "深色", "refresh_seconds": 60})

把临时文件放在目标目录,是为了让替换发生在同一文件系统。flush() 将 Python 缓冲区的数据交给系统,fsync() 请求系统将文件数据写入存储;finally 则在序列化或替换失败时清理临时文件。目标目录需要预先存在。

有两个细节值得按应用需求处理:替换后是新文件,原文件的权限等元数据不会自动继承;多个进程同时保存时,最后一次成功替换的内容会覆盖前面的结果,需要协调并发写入。已经打开旧文件的进程也需要重新打开路径,才能读到新内容。

这种做法适合普通本地配置文件:先把新内容准备完整,再切换路径指向的文件,避免一次失败的保存直接破坏旧配置。

【版权声明】本文为华为云社区用户原创内容,未经允许不得转载,如需转载请自行联系原作者进行授权。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。