Windows 下可用 os.open(path, os.O_RDONLY | os.O_EXCL) 捕获 PermissionError 判断文件被锁定;Linux/macOS 无对应语义,不应强行检测,而应转向容错处理或显式锁机制。

Windows 下用 os.open() 捕获 PermissionError 判断文件锁定
Windows 系统中,如果文件正被其他进程以独占方式打开(比如 Excel 正在编辑 .xlsx,或记事本以只读方式打开),os.open() 会立即抛出 PermissionError: [Errno 13] Permission denied。这是最轻量、最直接的检测方式。
注意:不能用 os.path.exists() 或 os.access() —— 它们只检查路径存在性和权限位,完全不感知 Windows 的文件句柄锁。
实操建议:
- 用
os.open(path, os.O_RDONLY | os.O_EXCL)尝试以排他只读方式打开(os.O_EXCL在 Windows 上对文件有效) - 捕获
PermissionError即表示被占用;捕获FileNotFoundError表示文件不存在;成功则说明当前可访问 - 务必在
finally中调用os.close(fd),否则会泄漏文件描述符
import os
def is_file_locked(path):
try:
fd = os.open(path, os.O_RDONLY | os.O_EXCL)
os.close(fd)
return False
except PermissionError:
return True
except FileNotFoundError:
return False # 文件不存在,不算“被锁”
Linux/macOS 下无法可靠检测文件是否被“锁定”
Unix-like 系统没有“文件锁定”这个概念(至少不是 Windows 那种强制句柄级锁)。进程可以随意 open() 同一个文件,即使它正在被另一个程序写入 —— 这是设计使然,不是 bug。
所以:flock()、fcntl() 等只是建议性锁(advisory lock),依赖所有参与者主动遵守;而 lsof 或 /proc/*/fd/ 查看谁在用该文件,需要 root 权限且开销大,不适合常规检查。
实操建议:
- 不要尝试在 Linux/macOS 上模拟 Windows 的“是否被锁”逻辑 —— 它没有对应语义,强行检测只会误导
- 如果你真正关心的是“能否安全读取”,直接尝试
open(path, 'rb')并捕获IOError/OSError更实际 - 若需协作控制,应改用显式锁机制(如
portalocker库 + 统一锁文件路径)
跨平台方案慎用 pathlib.Path().exists() 或 try/except OSError
很多人误以为 Path('x.txt').exists() 抛异常就代表被锁,其实它只在路径不可达(如权限不足、父目录无执行权)时才失败,和文件是否正被打开完全无关。
同样,泛泛地 try: open(...) except OSError 会混杂太多错误类型(磁盘满、编码错、路径过长……),无法精准区分“被占用”和“其他问题”。
实操建议:
- Windows:坚持用
os.open(..., os.O_EXCL)+PermissionError判断 - Linux/macOS:接受“无法可靠判断”的事实,把逻辑转向容错处理(如重试、超时、日志告警)
- 避免封装一个“跨平台 is_locked()”函数 —— 它在不同系统上语义根本不同,反而增加维护负担
用 psutil 查进程级文件占用(仅调试/诊断场景)
如果你不是做实时检查,而是想排查“到底哪个进程在用这个文件”,psutil 是唯一靠谱的跨平台工具。但它性能差、需额外安装、且必须有足够权限遍历所有进程的打开文件列表。
实操建议:
- 仅用于脚本诊断或运维工具,**不要**放入高频路径(如循环中每秒调用)
- Windows 上调用
psutil.Process().open_files()可能触发 UAC 或被杀毒软件拦截 - Linux 上需确保目标进程未启用
hidepid(否则非 root 用户看不到其 fd)
import psutil
def find_processes_using(path):
matches = []
for proc in psutil.process_iter(['pid', 'name']):
try:
for file in proc.open_files():
if file.path == path:
matches.append((proc.pid, proc.info['name']))
except (psutil.AccessDenied, psutil.NoSuchProcess):
pass
return matches
真正难的不是写几行检测代码,而是理解“文件被锁”这件事本身只在 Windows 上有明确定义;其他系统上硬要套用同一套逻辑,往往是在解决一个不存在的问题。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











