0

0

如何原子性地重命名文件(避免竞争条件)

冷漠man

冷漠man

发布时间:2026-01-27 17:39:11

|

555人浏览过

|

来源于php中文网

原创

rename()在同文件系统内重命名是原子操作,可静默替换目标文件且不可中断;跨文件系统需fallback到copy+unlink;os.rename()继承此特性,但需注意内容落盘需额外fsync。

如何原子性地重命名文件(避免竞争条件)

rename() 系统调用本身就是原子的

在绝大多数 POSIX 兼容系统(Linux、macOS、FreeBSD 等)上,rename() 系统调用对同一文件系统内的文件重命名是原子操作。这意味着:如果目标路径 dst 已存在,它会被静默替换(前提是进程有写权限);整个操作不可被中断,也不会出现“只改了一半名字”的中间状态。

关键限制是:源和目标必须位于同一挂载点(即同个文件系统)。跨文件系统调用 rename() 会失败并返回 EXDEV 错误。

Python 中用 os.rename() 实现原子重命名

Python 的 os.rename() 直接封装了底层 rename() 系统调用,因此具备相同原子性保证(同样要求同文件系统)。

常见错误写法是先 os.remove(dst)os.rename(src, dst) —— 这彻底破坏原子性,两步之间存在竞态窗口。

正确做法:

import os
try:
    os.rename("temp_file.json", "config.json")
except OSError as e:
    if e.errno == errno.EXDEV:
        # 跨文件系统,需 fallback 到 copy + unlink
        pass
    else:
        raise

跨文件系统时无法原子重命名,必须手动处理

rename() 返回 EXDEV,说明源和目标不在同一文件系统。此时没有单系统调用能保证原子性,只能组合操作,并接受极小窗口期(但比手动删+写安全得多):

企奶奶
企奶奶

一款专注于企业信息查询的智能大模型,企奶奶查企业,像聊天一样简单。

下载
  • shutil.copy2(src, dst)(保留时间戳、权限)
  • os.unlink(src)

注意:这个组合不是原子的。若在 copy 完成后、unlink 前崩溃,会残留临时文件;若在 copy 中断,则 dst 可能是不完整副本。生产环境如需强一致性,应配合校验、重试或使用临时目录+fsync。

Linux 上 renameat2() 提供更细粒度控制(较新内核)

Linux 3.15+ 支持 renameat2() 系统调用,可通过标志位增强语义,例如:

  • RENAME_EXCHANGE:原子交换两个路径的内容
  • RENAME_NOREPLACE:禁止覆盖已存在目标(避免意外删数据)
  • RENAME_WHITEOUT:用于 overlayfs 场景

Python 标准库暂未暴露 renameat2(),需通过 ctypes 或第三方包(如 oslo.utils)调用。普通场景用 os.rename() 已足够。

真正容易被忽略的是:原子性只保证「路径映射变更」这一层,不保证文件内容已刷盘。若需落盘持久化,应在 rename() 前对源文件 os.fsync()(打开文件描述符后),否则重命名后仍可能丢失最近写入的数据。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
macOS怎么切换用户账户
macOS怎么切换用户账户

在 macOS 系统中,可通过多种方式切换用户账户。如点击苹果图标选择 “系统偏好设置”,打开 “用户与群组” 进行切换;或启用快速用户切换功能,通过菜单栏或控制中心的账户名称切换;还能使用快捷键 “Control+Command+Q” 锁定屏幕后切换。

339

2025.05.09

磁盘配额是什么
磁盘配额是什么

磁盘配额是计算机中指定磁盘的储存限制,就是管理员可以为用户所能使用的磁盘空间进行配额限制,每一用户只能使用最大配额范围内的磁盘空间。php中文网为大家提供各种磁盘配额相关的内容,教程,供大家免费下载安装。

1394

2023.06.21

如何安装LINUX
如何安装LINUX

本站专题提供如何安装LINUX的相关教程文章,还有相关的下载、课程,大家可以免费体验。

705

2023.06.29

linux find
linux find

find是linux命令,它将档案系统内符合 expression 的档案列出来。可以指要档案的名称、类别、时间、大小、权限等不同资讯的组合,只有完全相符的才会被列出来。find根据下列规则判断 path 和 expression,在命令列上第一个 - ( ) , ! 之前的部分为 path,之后的是 expression。还有指DOS 命令 find,Excel 函数 find等。本站专题提供linux find相关教程文章,还有相关

295

2023.06.30

linux修改文件名
linux修改文件名

本专题为大家提供linux修改文件名相关的文章,这些文章可以帮助用户快速轻松地完成文件名的修改工作,大家可以免费体验。

779

2023.07.05

linux系统安装教程
linux系统安装教程

linux系统是一种可以免费使用,自由传播,多用户、多任务、多线程、多CPU的操作系统。本专题提供linux系统安装教程相关的文章,大家可以免费体验。

575

2023.07.06

linux查看文件夹大小
linux查看文件夹大小

Linux是一种自由和开放源码的类Unix操作系统,存在着许多不同的Linux版本,但它们都使用了Linux内核。Linux可安装在各种计算机硬件设备中,比如手机、平板电脑、路由器、视频游戏控制台、台式计算机、大型机和超级计算机。linux怎么查看文件夹大小呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

548

2023.07.20

linux查看ip命令
linux查看ip命令

本专题为大家提供linux查看ip命令相关文章内容,感兴趣的朋友可以免费下载体验试试。

300

2023.07.20

Python 自然语言处理(NLP)基础与实战
Python 自然语言处理(NLP)基础与实战

本专题系统讲解 Python 在自然语言处理(NLP)领域的基础方法与实战应用,涵盖文本预处理(分词、去停用词)、词性标注、命名实体识别、关键词提取、情感分析,以及常用 NLP 库(NLTK、spaCy)的核心用法。通过真实文本案例,帮助学习者掌握 使用 Python 进行文本分析与语言数据处理的完整流程,适用于内容分析、舆情监测与智能文本应用场景。

10

2026.01.27

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL 教程
PostgreSQL 教程

共48课时 | 7.9万人学习

Git 教程
Git 教程

共21课时 | 3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号