本文详解为何 `file.readline()` 在文件动态追加场景下返回空行，并提供线程安全、缓冲可控的实时日志监听解决方案。
在多线程环境中监听文件末尾新增内容（类似 Unix tail -f 行为）时，常见误区是仅对读取端做 seek(0, 2) 后循环调用 readline()，却忽略写入端的缓冲机制——这是导致 line 恒为空字符串的根本原因。
? 问题根源：写入缓冲未刷新
Python 默认以全缓冲（fully buffered） 模式打开文本文件（尤其是 a 追加模式）。这意味着即使你执行了 fd.write("data\n")，数据仍驻留在内存缓冲区中，尚未真正落盘。而 readline() 只能读取已写入磁盘的内容，因此始终读不到“新行”，返回空字符串 ''。
此外，readline() 在文件指针位于 EOF 时会立即返回空字符串（而非阻塞等待），这进一步加剧了“无响应”假象。
✅ 正确实践：双向控制缓冲行为
✅ 写入端：启用行缓冲或显式刷新
# 方案1：行缓冲模式（推荐）
with open("log.txt", "a", buffering=1) as f: # buffering=1 = line-buffered
f.write("INFO: Task started\n")
# 自动在换行符处刷新，无需手动 flush()
# 方案2：手动刷新（兼容性更强）
with open("log.txt", "a") as f:
f.write("INFO: Task completed\n")
f.flush() # 强制将缓冲区写入磁盘
✅ 读取端：避免阻塞+合理轮询
import time
import os
def tail_file(file_path, stop_event):
with open(file_path, 'r', encoding='utf-8') as f:
f.seek(0, 2) # 定位到文件末尾
while not stop_event.is_set():
line = f.readline()
if line: # 成功读到一行
print(f"→ {line.rstrip()}")
else: # EOF，短暂休眠后重试（避免 CPU 空转）
time.sleep(0.1)
⚠️ 注意：不要使用 time.sleep(1) 过长间隔，否则会显著增加日志延迟；建议 0.1–0.5 秒。
? 完整可运行示例（含线程同步）
from threading import Thread, Event
import time
def tail_thread(file_path, stop_event):
with open(file_path, 'r', encoding='utf-8') as f:
f.seek(0, 2) # 初始定位至末尾
while not stop_event.is_set():
line = f.readline()
if line:
print(f"[TAIL] {line.rstrip()}")
else:
time.sleep(0.2)
# 启动监听线程
stop = Event()
t = Thread(target=tail_thread, args=("app.log", stop))
t.start()
# 模拟日志写入（主程序）
with open("app.log", "a", buffering=1) as log:
for i in range(5):
log.write(f"LOG-{i}: Processing item {i}\n")
time.sleep(1)
stop.set()
t.join()
print("Tail stopped.")
? 关键总结
- ❌ 错误做法：仅调整读取端 seek()，忽视写入端缓冲；
- ✅ 正确做法：写入端启用 buffering=1 或调用 flush()，读取端配合短间隔轮询；
- ?️ 线程安全：open() 是线程安全的，但需确保同一文件不被多个线程同时写入（除非使用文件锁）；
- ? 性能提示：readline() 在大文件中效率优于 readlines()；若需解析结构化日志，建议结合 io.TextIOWrapper 的 reconfigure() 动态调整编码或错误处理策略。
通过精准控制 I/O 缓冲行为，即可稳定实现低延迟、高可靠性的文件实时监控功能。
