VS Code非交互模式下Python日志写入文件失效问题排查

一、两种运行模式的核心差异 #

• 交互模式（REPL）：代码逐行执行，进程不会立刻退出，文件流的缓冲操作能得到充分处理，再加上手动调用flush()，日志能及时写入磁盘。另外，REPL环境的工作目录通常就是你当前打开的VS Code文件夹，相对路径指向明确。
• 非交互模式（脚本运行）：脚本执行完毕后进程会快速终止，即使调用了flush()，底层文件缓冲可能还没完成磁盘同步；同时脚本的工作目录可能和交互模式不一致，导致日志文件生成在你没留意的路径，误以为没写入。

二、问题的具体原因 #

1. 进程退出导致缓冲未同步：Python进程退出时会快速清理资源，虽然你调用了flush()，但操作系统层面的写缓存可能还没把数据同步到磁盘，就被强制终止了。
2. 相对路径的工作目录歧义：交互模式下VS Code的工作目录是当前打开的文件夹，但非交互模式运行脚本时，工作目录可能是终端的默认路径或者脚本所在目录，./use_case_1.log并没有生成在你预期的位置。
3. 日志handler的清理顺序问题：进程退出时logging模块会自动清理所有handler，若清理逻辑先于缓冲写入完成，就会导致日志丢失。

三、解决建议 #

1. 用绝对路径指定日志文件 #

避免相对路径的歧义，直接生成脚本所在目录的日志文件：

import os
import logging

# 获取脚本所在目录的绝对路径
script_dir = os.path.dirname(os.path.abspath(__file__))
log_file = os.path.join(script_dir, 'use_case_1.log')

logger1 = logging.getLogger('use_case_1')
logger1.setLevel(logging.INFO)

handler1 = logging.FileHandler(log_file, 'a')
# 后续配置不变...

2. 显式关闭handler或用上下文管理器 #

确保所有缓冲数据写入磁盘后再退出：

# 方式1：显式关闭handler
logger1.info('Log message for use case 1')
handler1.flush()
handler1.close()

# 方式2：用上下文管理器自动管理handler
with logging.FileHandler(log_file, 'a') as handler1:
    formatter1 = logging.Formatter('%(asctime)s - %(levelname)s - %(message)s')
    handler1.setFormatter(formatter1)
    logger1.addHandler(handler1)
    logger1.info('Log message for use case 1')
# 上下文管理器会自动关闭handler，保证写入完成

3. 开启行缓冲模式 #

创建FileHandler时指定buffering=1，每写一行日志就立即刷新到磁盘：

handler1 = logging.FileHandler(log_file, 'a', buffering=1)

4. 脚本结束前调用logging.shutdown() #

强制所有日志handler完成写入并清理资源：

logger1.info('Log message for use case 1')
logging.shutdown()

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