python配置日志记录-Python教程-PHP中文网

python配置日志记录

舞夢輝影

发布： 2025-11-21 23:20:02

原创

993人浏览过

配置Python日志需先调用basicConfig设置级别、格式和输出位置，或创建Logger实例并添加Handler与Formatter以实现多目标输出；对于长期运行服务，应使用RotatingFileHandler或TimedRotatingFileHandler实现按大小或时间轮转日志文件。

python配置日志记录

H3 配置Python日志记录的基本方法

在Python中，logging 模块是内置的日志管理工具，使用它能有效记录程序运行过程中的信息。合理配置日志有助于调试和监控系统行为。

H3 使用 basicConfig 进行简单配置

最基础的配置方式是调用 logging.basicConfig()，可以在程序启动时一次性设置日志格式、输出位置和级别。

示例：

立即学习“Python免费学习笔记（深入）”；

import logging
<p>logging.basicConfig(
level=logging.INFO,                    # 设置最低记录级别
format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
filename='app.log',                   # 日志写入文件
filemode='a'                          # 追加模式
)</p><h1>使用日志</h1><p>logging.info("程序启动")
logging.warning("这是一个警告")
logging.error("发生错误")</p>

登录后复制

说明：

level：控制哪些级别的日志会被记录（DEBUG < INFO < WARNING < ERROR < CRITICAL）
format：定义日志输出格式，常用字段包括时间、日志器名、级别、消息内容
filename：指定日志文件路径，不设置则默认输出到控制台
filemode：'a' 表示追加，'w' 表示每次覆盖

H3 使用 Logger 对象实现更灵活控制

对于复杂项目，推荐创建独立的 Logger 实例，并添加 Handler 和 Formatter。

立即学习“Python免费学习笔记（深入）”；

import logging
<h1>获取一个独立的日志器</h1><p>logger = logging.getLogger('my_app')
logger.setLevel(logging.DEBUG)</p><h1>避免重复输出（防止向上级传递）</h1><p>logger.propagate = False</p>
                    <div class="aritcle_card">
                        <a class="aritcle_card_img" href="/xiazai/js/4786">
                            <img src="https://img.php.cn/upload/jscode/000/120/096/5db7d8f2e6055653.jpg" alt="数据源可配置的记事日历插件">
                        </a>
                        <div class="aritcle_card_info">
                            <a href="/xiazai/js/4786">数据源可配置的记事日历插件</a>
                            <p>数据源可配置的记事日历插件</p>
                            <div class="">
                                <img src="/static/images/card_xiazai.png" alt="数据源可配置的记事日历插件">
                                <span>52</span>
                            </div>
                        </div>
                        <a href="/xiazai/js/4786" class="aritcle_card_btn">
                            <span>查看详情</span>
                            <img src="/static/images/cardxiayige-3.png" alt="数据源可配置的记事日历插件">
                        </a>
                    </div>
                <h1>创建处理器：同时输出到文件和控制台</h1><p>fh = logging.FileHandler('debug.log')
ch = logging.StreamHandler()</p><h1>设置级别</h1><p>fh.setLevel(logging.DEBUG)
ch.setLevel(logging.INFO)</p><h1>定义格式</h1><p>formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(funcName)s - %(message)s')
fh.setFormatter(formatter)
ch.setFormatter(formatter)</p><h1>添加处理器</h1><p>logger.addHandler(fh)
logger.addHandler(ch)</p><h1>使用</h1><p>logger.debug("详细调试信息")
logger.info("普通提示")
logger.error("出错了！")</p>

登录后复制

这种方式的优点：

可为不同模块分配不同的日志器
支持多个输出目标（文件、控制台、网络等）
每个输出可以有不同的格式和级别控制

H3 日志轮转（按大小或时间切割）

长时间运行的服务会产生大量日志，建议使用 RotatingFileHandler 或 TimedRotatingFileHandler 自动分割日志文件。

立即学习“Python免费学习笔记（深入）”；

from logging.handlers import RotatingFileHandler
import os
<h1>按文件大小轮转</h1><p>handler = RotatingFileHandler(
'app.log',
maxBytes=10<em>1024</em>1024,   # 10MB
backupCount=5            # 保留5个备份
)</p>

登录后复制

立即学习“Python免费学习笔记（深入）”；

from logging.handlers import TimedRotatingFileHandler
import time
<h1>按时间轮转（每天一个文件）</h1><p>handler = TimedRotatingFileHandler(
'app.log',
when='midnight',
interval=1,
backupCount=7,
encoding='utf-8'
)</p><h1>文件名自动加上日期后缀</h1><p>handler.suffix = "%Y-%m-%d"</p>

登录后复制

基本上就这些。根据项目规模选择合适的配置方式，小项目用 basicConfig 就够了，大项目建议使用自定义 Logger + 多处理器的方式，便于维护和排查问题。

以上就是python配置日志记录的详细内容，更多请关注php中文网其它相关文章！