fileshare.none 是检测文件占用的黄金标准,因其要求完全独占访问,任何其他进程打开都会稳定抛出 hresult 为 0x80070020 的 ioexception,无竞态、不依赖系统语言,且最小代价探测只需只读+独占。

直接尝试以 FileShare.None 打开文件并捕获 IOException,是唯一可靠、无竞态、不依赖系统语言的判断方式。所有预检查(如 File.Exists)或试探性共享模式(如 FileShare.Read)都会误判。
为什么 FileShare.None 是检测占用的黄金标准
Windows 文件锁的本质是句柄级排他控制。FileShare.None 要求当前进程获得对文件的完全独占访问权 —— 只要其他任何进程已以任意模式(读/写/读写)打开了该文件,这次打开就会失败,并稳定抛出 IOException,其 HResult 为 unchecked((int)0x80070020)(即 Win32 错误码 32)。这比 FileShare.Read 或 FileShare.ReadWrite 敏感得多,后者可能在 Excel、记事本、NLog 日志写入器等常见场景下“成功打开”,却完全漏掉占用。
使用时注意:
-
File.Open(path, FileMode.Open, FileAccess.Read, FileShare.None)是最小代价探测:只读 + 独占,不修改文件,也不触发实际读取 - 不要用
File.OpenRead(path)—— 它默认FileShare.Read,失去检测能力 - 若你后续要写入,请模拟写入场景:
File.Open(path, FileMode.Open, FileAccess.Write, FileShare.Read),否则检测与实际操作不一致
如何正确捕获和识别占用异常
不是所有 IOException 都代表“被占用”。路径不存在、权限不足、磁盘满、网络断开等也会抛出同类异常。必须精准过滤错误码,而非依赖 Message 字符串。
Windows 下最稳的方式是检查 ex.HResult:
- 占用:
ex.HResult == unchecked((int)0x80070020)(ERROR_SHARING_VIOLATION) - 权限拒绝:
ex.HResult == unchecked((int)0x80070005)(ERROR_ACCESS_DENIED),也应视为不可用 - 避免用
ex.Message.Contains("used by another process")—— 中文系统报“该进程无法访问该文件”,英文系统内容不同,不可靠 - 某些封装(如异步包装)会把原始错误码藏在
ex.InnerException?.HResult,建议统一用Marshal.GetHRForException(ex)获取原始值
别写“试探-重试”循环:句柄泄漏和脏数据风险
有人试图用不同 FileShare 值反复试探,比如先试 None,失败再试 Read……这是危险操作:
- 每次
FileStream构造都真实申请系统句柄;循环试探极易耗尽句柄资源 - 若用
FileShare.Read成功打开,而此时另一进程正写入,你读到的就是中间态脏数据 -
File.OpenHandle(.NET 6+)虽轻量,但返回的SafeFileHandle必须显式释放,漏掉就内存泄漏 - 真正的非阻塞检测,只能是单次
try { using var _ = File.Open(...); } catch (IOException ex) when (IsSharingViolation(ex)) { ... },打开即关,不留句柄
跨平台兼容性要点
.NET Core/.NET 5+ 在 Linux/macOS 上,IOException.HResult 恒为 0,不能用于判断。此时需 fallback 到保守策略:
- 优先在 Windows 环境下验证逻辑(绝大多数生产部署仍是 Windows)
- 跨平台代码中,可加
RuntimeInformation.IsOSPlatform(OSPlatform.Windows)分支 - 非 Windows 下,仅作
ex.Message.Contains("busy") || ex.Message.Contains("in use")的弱匹配,不作为主判断依据 - 永远不要假设
Process.GetProcesses()或句柄扫描能可靠查出谁在占用 —— 权限受限、易漏判、非原子
真正难处理的不是“怎么写”,而是“什么时候该放弃”:占用可能是瞬时的(如杀毒软件扫描),也可能是长期的(如 Excel 未关闭)。检测逻辑本身必须极轻量、无副作用,而重试策略(间隔、次数、降级动作)得由业务层决定 —— 这部分没有银弹,只有结合日志、监控与用户反馈的持续调优。










