Python如何清空日志文件无空白残留，避免新日志前出现空行？

API 探路者

2026-10-4

问题原因

你遇到的问题核心是logging模块持有的文件句柄偏移量未同步更新：
logging初始化时就已经打开了日志文件的固定句柄，你手动通过新的open('w')操作清空文件时，logging内部持有的句柄的写入偏移量仍然停留在上次写日志结束的位置。后续logging写入新内容时，会直接从旧偏移量位置开始写入，偏移量0到旧偏移量之间的区域就会被系统填充为空字符，也就是你在记事本里看到的空白内容。

解决方案

方案1：直接通过logging的handler操作清空（无需重新加载配置）

直接操作logging已持有的文件句柄，同时重置偏移量和截断文件，不会出现偏移量不匹配的问题：

import logging

for handler in logging.root.handlers[:]:
    # 匹配你要清空的日志对应的FileHandler
    if isinstance(handler, logging.FileHandler) and "test_log.log" in handler.baseFilename:
        handler.stream.seek(0)  # 把文件指针移到开头
        handler.stream.truncate()  # 从指针位置开始截断文件，即清空全部内容

方案2：清空前后重置logging的FileHandler

如果需要完全重新初始化日志配置，可以先关闭旧handler、清空文件后再重新加载配置：

import logging
import os

# 1. 移除并关闭旧的FileHandler
for handler in logging.root.handlers[:]:
    if isinstance(handler, logging.FileHandler) and "test_log.log" in handler.baseFilename:
        handler.close()
        logging.root.removeHandler(handler)

# 2. 清空日志文件
fn_path = os.path.join(os.path.dirname(__file__), '..', 'logs', 'test_log.log')
fn_path = os.path.abspath(fn_path)
with open(fn_path, 'w') as f:
    f.truncate(0)

# 3. 重新加载logging配置，初始化新的FileHandler
logging.config.fileConfig("logging.ini")