如何为Python logging模块的FileHandler设置行缓冲？

logging默认的FileHandler使用系统默认缓冲策略，日志内容会暂存在内存缓冲区，直到缓冲区满、进程退出才会批量写入文件，无法满足实时查看的需求。你可以通过以下两种方式实现类似open(buffering=1)的行缓冲效果：

1. 自定义行缓冲FileHandler（推荐） #

重写FileHandler的_open方法，显式指定buffering=1开启行缓冲，配置后所有写入该Handler的日志都会在每行写完后自动刷入磁盘：

import logging

class LineBufferedFileHandler(logging.FileHandler):
    def _open(self):
        # 保留原Handler的所有配置，仅新增buffering=1参数开启行缓冲
        return open(
            self.baseFilename,
            self.mode,
            encoding=self.encoding,
            buffering=1,
            errors=self.errors
        )

# 调用示例
if __name__ == "__main__":
    logger = logging.getLogger("test_logger")
    logger.setLevel(logging.DEBUG)
    
    # 用自定义Handler替换默认FileHandler
    file_handler = LineBufferedFileHandler("runtime.log")
    log_formatter = logging.Formatter("%(asctime)s - %(levelname)s - %(message)s")
    file_handler.setFormatter(log_formatter)
    logger.addHandler(file_handler)
    
    # 测试：日志输出后会立即写入文件，无需等待脚本退出
    logger.info("第一条实时日志")

2. 手动刷写缓冲区（临时调试用） #

如果不想修改Handler定义，也可以在需要实时输出的日志语句后手动调用flush()方法强制刷写缓冲区：

logger.info("需要实时展示的日志")
# 遍历所有FileHandler执行刷写
for handler in logger.handlers:
    if isinstance(handler, logging.FileHandler):
        handler.flush()

注意：行缓冲仅在文本写入模式下生效，如果你配置了二进制写入模式，buffering=1不会生效。另外高频日志场景下开启行缓冲会增加IO开销，生产环境可以根据实际业务负载权衡使用。

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