如何在Python中以独占模式打开并锁定文件-Python教程-PHP中文网

flock在Linux/macOS上是最轻量的内核级建议性独占锁，需用os.open获取fd后调用，进程退出或fd关闭时自动释放；Windows不支持，应改用win32file.CreateFile或跨平台portalocker。

如何在python中以独占模式打开并锁定文件

Python中用`flock`实现独占文件锁（Linux/macOS）

在类Unix系统上，flock是最轻量、最常用的文件独占锁机制。它基于内核的 advisory lock，进程退出或文件描述符关闭时自动释放，无需手动清理。

关键点：必须用os.open打开文件获取原始文件描述符，再传给flock；不能对open()返回的file对象直接调用——那会报TypeError: argument must be an int。

使用os.O_RDWR | os.O_CREAT确保文件可读写且不存在时自动创建
加锁失败时默认阻塞，如需非阻塞，传fcntl.LOCK_EX | fcntl.LOCK_NB，捕获OSError（错误码errno.EAGAIN或errno.EACCES）
锁作用于整个文件，不支持区域锁；多个进程对同一文件描述符重复调用flock不会出错，但必须配对unlock或靠关闭fd释放

import fcntl
import os
<p>fd = os.open("data.txt", os.O_RDWR | os.O_CREAT)
try:
fcntl.flock(fd, fcntl.LOCK_EX)</p><h1>此处安全读写</h1><pre class="brush:php;toolbar:false;">with os.fdopen(fd, "r+") as f:
    f.write("updated\n")
    f.seek(0)
    print(f.read())

finally: fcntl.flock(fd, fcntl.LOCK_UN) # 显式解锁更稳妥 os.close(fd)

Windows下用`msvcrt.locking`或`win32file`

Windows没有flock，原生方案是msvcrt.locking，但它只能锁定文件的**字节范围**，且仅对已存在的文件有效，无法创建新文件并加锁——这和常见需求错位。

更可靠的做法是用pywin32的win32file模块，调用CreateFile以win32file.FILE_SHARE_NONE打开，实现真正的独占打开（open-time exclusive）：

如果文件正被其他进程以非共享模式打开，CreateFile会直接失败（抛pywintypes.error），无需额外加锁逻辑
该方式锁粒度是“整个文件句柄”，比flock更严格，也更难被绕过
注意：必须用win32file.CloseHandle关闭句柄，不能用close()或file.close()

import win32file
import win32event
<p>try:
h = win32file.CreateFile(
"data.txt",
win32file.GENERIC_READ | win32file.GENERIC_WRITE,
0,  # 不共享
None,
win32file.OPEN_ALWAYS,
0,
None
)</p><h1>成功即已独占，可安全操作</h1><pre class="brush:php;toolbar:false;">win32file.WriteFile(h, b"hello")
win32file.CloseHandle(h)

except win32file.pywintypes.error as e: if e.winerror == 32: # ERROR_SHARING_VIOLATION print("文件正被占用")

跨平台方案：用`portalocker`库统一处理

自己写平台判断容易漏掉边界情况（比如macOS的flock语义差异、Windows的句柄继承问题）。portalocker封装了这些细节，提供一致API。

python-code-analyz

专业Python代码分析与优化，支持语法检查、安全扫描、性能评估、复杂度分析及重构后优化代码生成。

下载

它内部对Linux/macOS用flock，Windows用LockFileEx（支持超时、可重入等），还处理了fork后子进程继承锁的问题。

安装：pip install portalocker
portalocker.lock默认阻塞，portalocker.unlock显式释放；也可用上下文管理器自动释放
若需带超时，用portalocker.Lock类，传timeout=5参数
注意：portalocker锁的是文件内容，不是路径名——符号链接指向同一inode时仍能互斥

import portalocker
<p>with open("data.txt", "a+") as f:
try:
portalocker.lock(f, portalocker.LOCK_EX)
f.write("locked write\n")
f.flush()
finally:
portalocker.unlock(f)  # 或直接让with块退出触发<strong>exit</strong></p>