Python logging配置写入文件却输出到标准输出的问题咨询

我来帮你一步步梳理这个问题，先从最容易忽略的参数错误说起，再分析导入顺序相关的影响：

1. 核心错误：混淆了filename和filemode参数 #

你当前的basicConfig调用里有个明显的参数误用：你把日志文件的路径传给了filemode，但这个参数的作用是指定日志文件的打开模式（比如'w'是覆盖写入，'a'是追加，默认是'a'），而指定日志文件路径的正确参数是filename！

错误的代码：

logging.basicConfig(filemode='example.log', level=logging.DEBUG)

修正后的代码：

if __name__ == '__main__':
    logging.basicConfig(filename='example.log', level=logging.DEBUG)
    logging.debug('This message should go to the log file')

这个错误直接导致basicConfig没有配置文件输出，所以日志会默认输出到标准输出。至于Jupyter里能正常工作，大概率是你在Jupyter运行时不小心写对了参数，或者Jupyter的日志环境有特殊处理，可以再核对一下Jupyter里的代码。

2. 导入顺序引发的日志提前初始化 #

你提到导入顺序可能有影响，这个判断是对的：logging.basicConfig只有在root logger还没有任何Handler的时候才会生效。如果在调用它之前，任何代码（包括你导入的模块）已经触发过日志输出（比如调用logging.info()、logging.debug()），或者手动给root logger添加过Handler，那么basicConfig就不会再创建新的Handler了，日志还是会走之前的默认输出（标准输出）。

你列出的导入模块都是标准库（argparse/time/os/sys/json），这些本身不会触发logging初始化，但要检查：

• 有没有在if __name__ == '__main__'之前的代码里，不小心调用过logging相关方法？
• 有没有导入其他你自己写的模块，里面提前使用了logging？

如果确实存在提前初始化的情况，可以手动清除root logger的现有Handler后再重新配置：

if __name__ == '__main__':
    # 清除root logger已有的所有Handler
    for handler in logging.root.handlers[:]:
        logging.root.removeHandler(handler)
    # 重新配置日志
    logging.basicConfig(filename='example.log', level=logging.DEBUG)
    logging.debug('This message should go to the log file')

3. 验证配置是否生效 #

可以在配置后打印root logger的Handler列表，确认是否成功添加了FileHandler：

if __name__ == '__main__':
    logging.basicConfig(filename='example.log', level=logging.DEBUG)
    # 打印当前root logger的所有Handler
    print("Root logger handlers:", logging.root.handlers)
    logging.debug('This message should go to the log file')

如果输出里包含FileHandler实例，说明配置生效；如果只有StreamHandler，那就要回到前面的原因继续排查。

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