Python日志不写入文件问题及多文件项目日志最佳实践咨询

一、多文件项目日志配置及最佳实践确认 #

你的配置方式属于Python日志系统的最佳实践范畴，优势很明显：

• 配置与业务解耦：把日志配置单独放在legging_config.py文件中，不用在业务代码里零散写配置，修改和维护都更方便。
• 模块级日志溯源：每个文件通过getLogger(__name__)获取实例，日志里会明确显示来源模块（比如控制台里的__main__、something），排查问题时能快速定位到代码位置。
• 兼容多模块日志：设置disable_existing_loggers=False，不会在配置时意外禁用其他模块已创建的日志实例，保证多文件项目的日志都能正常工作。

二、日志文件为空的原因及解决方法 #

核心原因 #

你在配置里给名为logger的日志实例绑定了file处理器，但实际代码中使用的是__main__（main.py）和something（something.py）这两个日志实例，它们并没有关联到file处理器。而root日志只配置了console处理器，所以所有日志只会输出到控制台，不会写入文件。

两种解决方法 #

方法1：给root日志添加file处理器

直接修改legging_config.py中的root节点，把file处理器加进去：

"root": {"handlers": ["console", "file"], "level": "DEBUG"},

这种方式最简单，所有模块的日志都会继承root的配置，同时输出到控制台和文件。

方法2：配置通用模块日志规则

在loggers节点里添加一个空字符串的日志配置，用来匹配所有未单独配置的模块：

"loggers": {
    "": {  # 空字符串匹配所有模块的日志实例
        "handlers": ["console", "file"],
        "level": "DEBUG",
        "propagate": False,
    }
},

这种方式更灵活，后续如果需要给某个特定模块单独设置日志规则（比如调整级别、更换处理器），直接在loggers里新增对应模块名的配置即可。

修改后效果 #

调整配置后重新运行项目，main.log会正常写入所有日志内容，和控制台输出完全一致。

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