python中如何用logging把日志输出到文件和控制台？

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

python中如何用logging把日志输出到文件和控制台？

2025-11-26

浏览次数：次

返回列表

答案：通过添加FileHandler和StreamHandler，可实现日志同时输出到文件和控制台。首先创建logger并设置级别，防止重复添加handler需清空已有handler或禁用propagate；接着分别为文件和控制台创建handler，设定Formatter格式化输出，并可独立设置级别如文件DEBUG、控制台INFO；推荐使用dictConfig方式集中管理配置，便于维护。示例中日志写入app.log并输出到控制台，支持中文编码utf-8，避免重复日志与层级传递问题。

python中如何用logging把日志输出到文件和控制台？

在 Python 中使用 logging 模块同时将日志输出到文件和控制台，需要为 logger 添加多个 handler：一个 FileHandler 用于写入文件，一个 StreamHandler 用于输出到控制台。

1. 基本配置示例

以下代码展示如何设置日志同时输出到文件 app.log 和控制台：

import logging
<h1>创建 logger</h1><p>logger = logging.getLogger('my_logger')
logger.setLevel(logging.DEBUG)  # 设置日志级别</p><h1>防止重复添加 handler（重要）</h1><p>logger.propagate = False
if logger.handlers:
logger.handlers.clear()</p><h1>创建 handler：文件和控制台</h1><p>file_handler = logging.FileHandler('app.log', encoding='utf-8')
console_handler = logging.StreamHandler()</p><h1>设置日志格式</h1><p>formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
file_handler.setFormatter(formatter)
console_handler.setFormatter(formatter)</p><h1>设置 handler 的日志级别（可不同）</h1><p>file_handler.setLevel(logging.DEBUG)
console_handler.setLevel(logging.INFO)</p><h1>添加 handler 到 logger</h1><p>logger.addHandler(file_handler)
logger.addHandler(console_handler)</p><h1>使用 logger</h1><p>logger.debug('这是调试信息')
logger.info('这是普通信息')
logger.warning('这是警告')
logger.error('这是错误')</p>

2. 关键点说明

避免重复日志：如果多次运行脚本或在模块中定义 logger，可能重复添加 handler。清空已有 handler 或使用唯一命名可避免该问题。
propagate=False：防止日志向上传递给父 logger（如 root），避免意外重复输出。
不同级别输出：可以为文件设置 DEBUG 级别，记录所有细节；控制台设为 INFO，只显示重要信息，便于调试与监控平衡。
编码设置：写入中文日志时，FileHandler 应指定 encoding='utf-8' 防止乱码。

3. 使用 dictConfig 简化配置（推荐）

对于复杂项目，可用 dictConfig 统一管理：

Python v2.4 中文手册 chm

Python v2.4版chm格式的中文手册，内容丰富全面，不但是一本手册，你完全可以把她作为一本Python的入门教程，教你如何使用Python解释器、流程控制、数据结构、模板、输入和输出、错误和异常、类和标准库详解等方面的知识技巧。同时后附的手册可以方便你的查询。

2 查看详情 Python v2.4 中文手册 chm

import logging.config
<p>LOGGING_CONFIG = {
'version': 1,
'disable_existing_loggers': False,
'formatters': {
'standard': {
'format': '%(asctime)s - %(name)s - %(levelname)s - %(message)s'
},
},
'handlers': {
'file': {
'level': 'DEBUG',
'class': 'logging.FileHandler',
'filename': 'app.log',
'encoding': 'utf-8',
'formatter': 'standard',
},
'console': {
'level': 'INFO',
'class': 'logging.StreamHandler',
'formatter': 'standard',
},
},
'loggers': {
'my_logger': {
'handlers': ['file', 'console'],
'level': 'DEBUG',
'propagate': False
}
}
}</p><p>logging.config.dictConfig(LOGGING_CONFIG)
logger = logging.getLogger('my_logger')</p><p>logger.info('通过 dictConfig 配置的日志')</p>