多线程直接写文件会因POSIX文件偏移量与缓冲区不一致导致内容错乱、覆盖或丢失；正确做法是用共享threading.Lock包裹open到close全过程，或优先使用线程安全的logging模块。
为什么直接多线程写文件会出问题
多个线程调用 open(..., 'a') 或 f.write() 时，操作系统层面的文件偏移量（file offset）和缓冲区状态不一致，导致内容错乱、覆盖或丢失。这不是 Python 的 bug，而是 POSIX 文件 I/O 模型决定的：即使追加模式（'a'），write() 系统调用本身不是原子操作，尤其在高并发小写入场景下极易复现。
常见错误现象包括：
- 一行日志被截断成两行（如
"user_id=123, status=ok"写成"user_id=123, stat"和"us=ok"） - 同一行内容重复出现多次
- 文件末尾出现不可见的 \x00 字节或乱码
threading.Lock 怎么用才真正起作用
关键点：锁对象必须是**所有线程共享的同一个实例**，且要包裹**整个写入动作**（打开 + 写 + 关闭），不能只锁 f.write()。否则仍可能多个线程同时执行 open()，拿到各自独立的文件句柄，锁就失效了。
正确做法：
立即学习“Python免费学习笔记（深入）”；
- 在模块级或类实例属性中定义一个
threading.Lock()对象，不要在每个线程里新建 - 用
with lock:包裹从open()到f.close()的全过程 - 避免使用
print(..., file=f)这类隐式写法，统一用f.write()+ 手动换行
示例：
import threading
<p>log_lock = threading.Lock() # 共享锁</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill9965" title="macOS UI 自动化技能包 —— 用 Python 控制你的 Mac"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20dbae7c507.jpg" alt="macOS UI 自动化技能包 —— 用 Python 控制你的 Mac" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill9965" title="macOS UI 自动化技能包 —— 用 Python 控制你的 Mac">macOS UI 自动化技能包 —— 用 Python 控制你的 Mac</a>
<p>让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript
系统要求
macOS 14+ (Sonoma)
Python 3.9+
需要开启：辅助功能 + 屏幕录制权限</p>
</div>
<a href="/xiazai/skill9965" title="macOS UI 自动化技能包 —— 用 Python 控制你的 Mac" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><p>def write_log(message):
with log_lock: # 必须在这里进入临界区
with open("app.log", "a") as f:
f.write(f"[{threading.current_thread().name}] {message}\n")
Lock 不解决但你必须知道的副作用
加锁能保数据不乱，但会显著降低吞吐量——所有写请求串行化。如果每秒写几百次，瓶颈立刻出现在锁竞争上。
更严重的是：如果某个线程在写文件时抛异常（比如磁盘满、权限被撤），而你没在 with 块里处理，锁可能被永久持有（虽然 Python 的 with 在绝大多数情况下能保证释放，但极端异常如 os._exit() 或 SIGKILL 仍可能绕过）。所以：
- 永远用
with open()而非手动f = open(); ...; f.close() - 在写入前做必要校验（如
os.access(path, os.W_OK)） - 对关键日志考虑 fallback 方案（如内存缓冲 + 定时刷盘）
比 Lock 更适合日志场景的替代方案
如果你只是记日志，别自己造轮子。Python 标准库的 logging 模块默认就是线程安全的，底层已用锁保护 handler 的 emit() 方法。
直接用它更可靠：
import logging
logging.basicConfig(
filename="app.log",
level=logging.INFO,
format="%(asctime)s [%(threadName)s] %(message)s"
)
logging.info("User login succeeded") # 自动线程安全
自建 threading.Lock 只应在以下情况考虑：需要精确控制写入格式（比如二进制协议包）、必须绕过 logging 的格式化开销、或写入非文本文件（如 SQLite 的 WAL 模式除外，那该用数据库锁）。
真要自己锁文件，记住：锁的是「写行为」，不是「文件路径」；锁粒度越粗越安全，也越慢；而 logging 已经帮你平衡好了这个权衡。
