Python日志配置详解（从零开始掌握logging模块与日志文件配置）

为什么需要日志配置？

直接在代码中写 print() 虽然简单，但无法灵活控制日志级别（如 DEBUG、INFO、WARNING、ERROR）、输出格式或保存到文件。而使用 logging模块 配合配置文件，可以：

• 按不同级别记录信息
• 同时输出到控制台和文件
• 自定义时间戳、模块名等格式
• 无需修改代码即可调整日志行为

使用配置文件配置日志

Python 支持通过 .ini、.yaml 或 .json 文件来配置日志。最常用的是 .ini 格式，因为它简单直观。

步骤 1：创建日志配置文件

在项目根目录下新建一个名为 logging.conf 的文件，内容如下：

[loggers]keys=root[handlers]keys=consoleHandler,fileHandler[formatters]keys=simpleFormatter[logger_root]level=DEBUGhandlers=consoleHandler,fileHandler[handler_consoleHandler]class=StreamHandlerlevel=INFOformatter=simpleFormatterargs=(sys.stdout,)[handler_fileHandler]class=FileHandlerlevel=DEBUGformatter=simpleFormatterargs=('app.log',)[formatter_simpleFormatter]format=%(asctime)s - %(name)s - %(levelname)s - %(message)sdatefmt=%Y-%m-%d %H:%M:%S

步骤 2：在 Python 代码中加载配置

创建一个 main.py 文件，加载上述配置并使用日志：

import loggingimport logging.config# 加载配置文件logging.config.fileConfig('logging.conf')# 获取 loggerlogger = logging.getLogger(__name__)# 记录不同级别的日志logger.debug("这是一条调试信息")logger.info("程序正常运行")logger.warning("注意：可能存在风险")logger.error("发生了一个错误！")

运行效果说明

运行 main.py 后：

• 控制台会显示 INFO 及以上级别的日志（因为 consoleHandler 设置为 INFO）
• 文件 app.log 会记录所有 DEBUG 及以上级别的日志

这样，你就实现了灵活的 日志文件配置！

常见问题与技巧

✅ 日志级别顺序：DEBUG < INFO < WARNING < ERROR < CRITICAL
✅ 配置热更新：可通过监听文件变化动态重载配置（高级用法）
✅ 多模块日志：每个模块使用 logging.getLogger(__name__) 可自动记录模块名

总结

通过本篇 Python日志教程，你已经掌握了如何使用配置文件来管理日志输出。这种方式不仅让代码更整洁，还极大提升了日志系统的可维护性和灵活性。无论你是初学者还是有经验的开发者，合理使用 Python日志配置 都能让你的项目更加专业可靠。

立即动手试试吧！你的下一个 Python 项目值得拥有清晰、可控的日志系统。