讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

立刻MV
立刻MV

低成本歌曲 MV、视频生成

剧云
剧云

中文短剧剧本制作平台

AniShort
AniShort

AI短剧协同制作平台

C# 文件系统的IO路径原子性 C#rename操作为什么通常是原子的

冬墨酱_9755

冬墨酱_9755

发布时间:2026-02-23 10:06:10

|

431人浏览过

|

来源于php中文网

原创

Windows上File.Move同卷操作是原子的,因调用MoveFileEx+MOVEFILE_REPLACE_EXISTING,仅更新元数据;跨卷则退化为复制+删除,非原子。

c# 文件系统的io路径原子性 c#rename操作为什么通常是原子的

Windows 上 File.Move 为什么常被当作原子操作用

在 Windows(NTFS)上,File.Move 对**同一卷内**的重命名(rename)操作,底层调用的是 MoveFileEx 并传入 MOVEFILE_REPLACE_EXISTING 标志,它最终由文件系统驱动通过原子化的元数据更新完成——不涉及数据块拷贝,只改目录项和 MFT 记录。所以只要源路径和目标路径在同一磁盘卷,这个操作就是原子的:要么全部成功(文件出现在新位置、旧位置消失),要么完全失败(原文件完好无损),不会出现“一半在旧路径、一半在新路径”的中间态。

  • 仅限同卷:跨卷移动(比如 C: → D:)会退化为“复制 + 删除”,显然非原子
  • 不保证内容可见性:原子 ≠ 即时同步到所有 CPU 缓存;若其他进程正用 FileStream 持有该文件句柄,Move 仍可能成功,但对方读写行为未定义
  • 权限与锁影响结果:目标路径被占用、权限不足、或文件正被独占打开,都会抛出 IOException,不是“部分成功”

File.Replace 是更安全的原子替换方案

当你需要“用新文件安全覆盖旧文件”(比如更新配置、升级资源),直接 File.Delete + File.Copy 有明显窗口期:删完还没写入时崩溃,旧文件就丢了。File.Replace 则利用 NTFS 的“事务性重命名”能力,把旧文件先备份(可选),再原子地把新文件“切换”成目标名,整个过程不可中断。

C#
C#

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载
  • 签名是 File.Replace(string sourceFileName, string destinationFileName, string? backupFileName)
  • 如果 backupFileName 不为 null,旧文件会被移到备份路径;否则直接丢弃
  • 注意:备份路径必须与目标路径同卷,否则抛 ArgumentException
  • Linux/macOS 不支持此 API(.NET 6+ 在这些平台会回退为非原子的拷贝+删除)

别信“File.Move 总是原子”——常见翻车点

很多开发者看到文档里写“atomic on same volume”就默认高枕无忧,结果在线上出问题。根本原因在于:原子性只承诺**文件系统层面的路径变更**,不兜底你的业务语义。

  • 目标路径存在且是目录?抛 UnauthorizedAccessException,不是静默失败
  • 路径含非法字符(如 *、?)或超长(>260 字符且未启用长路径支持),提前在托管层报错,根本没进系统调用
  • 使用 UNC 路径(\servershare)时,实际行为取决于远程服务器的文件系统和 SMB 版本,Windows Server 2012+ 的 SMB 3.0 才较可靠支持原子重命名
  • File.Move 不刷新其他进程的目录缓存;某线程刚列完目录又执行 Move,下次再列可能还看到旧名(需手动 Directory.Refresh() 或加重试)

跨平台原子重命名?没有银弹,只有取舍

.NET 本身不提供跨平台原子 rename,因为 Linux(ext4/xfs)和 macOS(APFS)虽支持 rename(2) 系统调用(同挂载点下是原子的),但 .NET 的 File.Move 在非 Windows 上只是封装了该调用,并不额外保证更高层语义。

  • 同挂载点:Linux/macOS 的 File.Move 和 Windows 一样,是原子的
  • 不同挂载点(哪怕都是本地磁盘):必然跨设备,rename(2) 失败,.NET 回退为 copy+delete,非原子
  • 容器/网络存储场景更复杂:OverlayFS、NFSv3、S3 兼容网关等,rename 可能被模拟实现,原子性彻底失效
  • 真正要跨平台强保障?只能自己加锁(如 FileSystemWatcher + 临时文件 + 原子写入标志位)或依赖数据库事务记录状态
事情说清了就结束。原子性永远绑定在具体环境和操作粒度上,文件系统说原子,不等于你的业务逻辑自动变安全。

热门AI工具

更多
Loomy
Loomy Hot

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

Atoms
Atoms Hot

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

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

WorkBuddy

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

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

DeepSeek

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

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

豆包大模型

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

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

7299

2023.08.02

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

549

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1698

2024.03.01

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

4738

2023.08.10

数据库Delete用法
数据库Delete用法

数据库Delete用法:1、删除单条记录;2、删除多条记录;3、删除所有记录;4、删除特定条件的记录。更多关于数据库Delete的内容,大家可以访问下面的文章。

3471

2023.11.13

drop和delete的区别
drop和delete的区别

drop和delete的区别:1、功能与用途;2、操作对象;3、可逆性;4、空间释放;5、执行速度与效率;6、与其他命令的交互;7、影响的持久性;8、语法和执行;9、触发器与约束;10、事务处理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1045

2023.12.29

windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

3439

2023.07.26

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2978

2023.07.27

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

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

40

2026.11.06

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习

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

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