PyQt5中如何实现日志同时输出到终端与文件并实时刷新？

问题分析 #

你的代码核心逻辑框架没问题，但日志文件需等到程序退出才写入，根源在于文件缓冲策略和flush触发时机：

• Python默认文本文件采用全缓冲或行缓冲机制，在PyQt事件循环这类非交互式环境下，缓冲区不会自动刷新
• 现有代码仅在flush方法被调用时才刷新缓冲区，但print默认不会主动触发stdout.flush()，导致输出内容积压在内存缓冲区中，直到程序退出才一次性写入文件

修复后的代码 #

#!/usr/bin/env python

import sys

class LoggerFile(object):
    def __init__(self, log_path):
        # 启用行缓冲模式，确保每行输出能及时写入文件
        self.log = open(log_path, "w", buffering=1)
        self.terminal = None

    def write(self, message):
        self.terminal.write(message)
        self.log.write(message)
        # 写完立即刷新缓冲区，保证输出实时同步到文件
        self.flush()

    def flush(self):
        self.terminal.flush()
        self.log.flush()

    def __del__(self):
        # 程序退出时确保日志文件被正确关闭
        if not self.log.closed:
            self.log.close()

class LoggerOut(LoggerFile):
    def __init__(self):
        super().__init__("logfile.log")
        self.terminal = sys.stdout

class LoggerErr(LoggerFile):
    def __init__(self):
        super().__init__("logfile.log")
        self.terminal = sys.stderr

# 替换标准输出/错误流
sys.stdout = LoggerOut()
sys.stderr = LoggerErr()

from PyQt5.QtWidgets import QApplication, QMainWindow, QPushButton

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        print("Hello from MainWindow")
        self.setWindowTitle("My App")
        button = QPushButton("Press me!")
        button.clicked.connect(self.button_clicked)
        self.setCentralWidget(button)

    def button_clicked(self, s):
        print("click", s)

def main(argv=None):
    print("Hello from main")
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    app.exec()

if __name__ == '__main__':
    main()

关键修改说明 #

1. 设置行缓冲模式：打开日志文件时添加buffering=1，让文件每次写入一行后自动刷新缓冲区，配合手动flush进一步保证实时性。
2. 实时触发刷新：在write方法中写完内容后立即调用flush，无需依赖print(flush=True)这类额外设置，确保每一次输出都同步到文件。
3. 优化文件生命周期：新增__del__方法，保证程序退出时日志文件被正确关闭，避免缓冲区残留内容丢失。
4. 调整文件初始化时机：将日志文件打开逻辑移到__init__方法中，避免类加载阶段过早打开文件，同时让日志路径配置更灵活。

进阶无缓冲配置（可选） #

如果需要不等待换行的实时写入（比如输出无换行的进度信息），可以改用二进制模式打开文件并设置无缓冲：

# 在LoggerFile的__init__中修改
self.log = open(log_path, "wb", buffering=0)

# 对应的write方法修改为
def write(self, message):
    self.terminal.write(message)
    self.log.write(message.encode('utf-8'))
    self.flush()

内容的提问来源于stack exchange，提问作者sdbbs