讲师中心 微信公众号

工具推荐

视频效率加速
AniShort
AniShort

AI短剧协同制作平台

立刻MV
立刻MV

低成本歌曲 MV、视频生成

Laper
Laper

剧本策划到成片协作

updream

一键生成高质量推广成片

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

酷静姑娘_4046

酷静姑娘_4046

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

|

595人浏览过

|

来源于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) —— 这彻底破坏原子性,两步之间存在竞态窗口。

正确做法:

Todo List for MacOS
Todo List for MacOS

仅限macOS - 通过AppleScript管理macOS提醒事项应用。支持全功能提醒管理:添加、列出、完成、删除、搜索、创建列表等。

下载
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工具

更多
蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

相关专题

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

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

5544

2025.05.09

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

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

4510

2023.06.21

如何安装LINUX
如何安装LINUX

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

3773

2023.06.29

linux find
linux find

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

3073

2023.06.30

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

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

7630

2023.07.05

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

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

7262

2023.07.06

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

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

4133

2023.07.20

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

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

3605

2023.07.20

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

60

2026.11.06

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn