如何使用Python logging库实现控制台行覆盖输出

我懂你想要的效果——用Python的logging库实现和普通print一样的控制台行覆盖：运行过程中每行显示...，完成后在同一行替换成OK，不会产生多行冗余日志，就像你这段print代码实现的效果：

import time

for i in range(10):
    print(f'Progress: {i+1}/10 ...', end='')
    time.sleep(1)
    print(f'\rProgress: {i+1}/10  OK')

你现在用自定义OverwriteStreamHandler的方式确实有点啰嗦，不够Pythonic，这里有两个更简洁顺手的思路可以参考：

方案一：简化自定义Handler，用extra参数灵活控制覆盖 #

我们可以把自定义Handler的逻辑简化，同时用日志的extra参数来控制单条日志是否需要覆盖，不用创建多个logger：

import logging
import sys
import time

class OverwriteHandler(logging.StreamHandler):
    def emit(self, record):
        msg = self.format(record)
        # 回到行首输出消息
        self.stream.write(f'\r{msg}')
        self.stream.flush()
        # 如果这条日志不需要继续覆盖，就加个换行，避免后续日志被覆盖
        if not getattr(record, 'overwrite', True):
            self.stream.write('\n')

# 全局配置logger
logging.basicConfig(
    level=logging.INFO,
    format='%(message)s',
    handlers=[OverwriteHandler(sys.stdout)]
)
logger = logging.getLogger()

for i in range(10):
    # 运行时输出...，标记为需要覆盖
    logger.info(f'Progress: {i+1}/10 ...', extra={'overwrite': True})
    time.sleep(1)
    # 完成后输出OK，标记为不需要覆盖，自动换行
    logger.info(f'Progress: {i+1}/10  OK', extra={'overwrite': False})

这个方案的优势是灵活性强，适合在项目中多处使用覆盖式日志的场景，通过extra参数就能轻松控制单条日志的行为。

方案二：轻量实现——不用自定义Handler，直接控制输出字符 #

如果只是小脚本或者临时需求，完全不用自定义Handler，只需要调整日志Handler的终止符，配合\r控制字符就能实现：

import logging
import sys
import time

# 配置日志处理器，去掉默认的换行符
handler = logging.StreamHandler(sys.stdout)
handler.setFormatter(logging.Formatter('%(message)s'))
handler.terminator = ''  # 关键：禁用默认的换行输出

logger = logging.getLogger()
logger.addHandler(handler)
logger.setLevel(logging.INFO)

for i in range(10):
    # 回到行首输出运行时消息
    logger.info(f'\rProgress: {i+1}/10 ...')
    sys.stdout.flush()  # 确保消息立刻输出到控制台
    time.sleep(1)
    # 输出最终结果，最后加换行避免后续日志被覆盖
    logger.info(f'\rProgress: {i+1}/10  OK\n')

这个方案更轻量，没有额外的类定义，核心就是通过handler.terminator = ''去掉日志默认的换行，再用\r回到行首实现覆盖，非常简洁。

两种方案都比你原来的实现更简洁，也更符合Python的简洁风格。如果是小型脚本用方案二就行，大型项目需要复用覆盖日志逻辑的话，方案一更易维护。

备注：内容来源于stack exchange，提问作者Scoodood