Python中logging模块用法示例总结

2025-08-30 14:50
文章标签 python logging 模块 总结 用法 示例

本文主要是介绍Python中logging模块用法示例总结，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

《Python中logging模块用法示例总结》在Python中logging模块是一个强大的日志记录工具,它允许用户将程序运行期间产生的日志信息输出到控制台或者写入到文件中,：本文主要介绍Pyt...

前言

logging是python中拿来进行日志记录的标准库，可以方便地跟踪程序的运行状态，再也不需要手动添加一大堆的print了！

这篇文章目的是简单地介绍一下它的基本用法，其实这个模块内容还挺多的，包括记录器、处理器、过滤器、格式器等多种工具。不过对于平常的应用，记录器就够了。

一. 基本使用

1. 五种日志等级

首先导入logging，然后可以直接使用下面的函数来记录：

  • logging.debug()，调试细节信息，严重程度最低。
  • logging.info()，普通的消息。
  • logging.warning()，警告，但是程序仍可以执行；默认报告此级别及以上的日志。
  • logging.error()，错误，可能导致程序部分功能失败。
  • logging.critical()，严重错误，可能导致程序直接失败。

下面是例子：

import logging

logging.debug('调试')
logging.info('信息')
# 默认忽略以上两个等级的信息
logging.warning('警告')
logging.error('错误')
logging.critical('重大错误')

Python中logging模块用法示例总结

默认情况下，日志是下面的格式：

  • {日志等级}:{日志记录器名称}:{消息} 

2.  设置报告等级

想要自己定义日志的行为，可以使用logging.basicConfig()来设置。比如，通过指定level可以更改进行报告的最低日志等级：

import logging

logging.basicConfig(
    level=logging.DEBUG
)

logging.debug('调试')
logging.info('信息')
# 现在上面两条信息也会报告
logging.warning('警告')
logging.error('错误')
logging.critical('重大错误')

Python中logging模块用法示例总结

3. 自定义格式

默认的日志格式不太好看，我们可以自定义日志的输出格式。只要在basicConfig里设置format就可以了。下面是一些常用的可选项：

  •  %(asctime)s，表示人类易读的日志生成时间。 默认形式为 '2003-07-08 16:49:45,896' （逗号之后的数字为时间的毫秒部分）。
  • %(filename)s，执行报告的文件路径中的文件名部分。
  • %(module)s，执行日志记录的模块名称。
  • %(levelname)s，日志的等级。
  • %(name)s，日志记录器的名称，如果直接用logging就是“root”。
  • %(message)s，日志的具体信息。

如要了解全部选项，可以去官方文档查看：

logging：https://docs.python.org/zh-cn/3.13/library/logging.html#logrecord-attributes

比如，下面以自定义格式进行日志记录：

import logging

logging.basicConfig(
    level=logging.DEBUG,
    format='报告时间:%(asctime)s 报告等级:%(levelname)s; %(message)s'
)

logging.debug('调试')
logging.info('信息')
logging.warning('警告')
logging.error('错误')
logging.critical('重大错误')

Python中logging模块用法示例总结

那个asctime还可以自己定义行python为，只要指定datefmt即可。 它的格式化微语言和datetime一样，下面是AI整理的表格：

Python中logging模块用法示例总结

Python中logging模块用法示例总结

比如，下面的方法让asctime只输出日期和时分秒：

import logging

logging.basicConfig(
    level=logging.DEBUG,
    format='报告时间:%(asctime)s 报告等级:%(levelname)s; %(message)s',
    datefmt='%d日 %H时 %M分 %S秒'
)

logging.debug('调试')
logging.info('信息')
logging.warning('警告')
logging.error('错误')
logging.critical('重大错误')

Python中logging模块用法示例总结

4. C语言风格的格式化方法

如果我想在日志信息中使用一些变量该怎么办呢？处了用Python的方法，也可以用%s这种C风格的格式化方法，logging是一个元老级的模块，采用这种远古方式是为了向下兼容。

下面是Python的方法：

import logging

logging.basicConfig(
    level=logging.DEBUG,
    format='报告时间:%(asctime)s编程 报告等级:%(levelname)s; %(message)s',
    datefmt='%d日 %H时 %M分 %S秒'
)

param = '你好，我是变量！'

logging.debug(f'变量：{param}')

Python中logging模块用法示例总结

下面是C风格的方法：

import logging

logging.basicConfig(
    level=logging.DEBUG,
    format='报告时间:%(asctime)s 报告等级:%(levelname)s; %(message)s',
    datefmt='%d日 %H时 %M分 %S秒'
)

param1 = 'param1'
param2 = 'param2'
param3 = 'param3'

logging.debug('我有三个变量,它们是:\n%s\n%s\n和%s', param1, param2, param3)

Python中logging模块用法示例总结

5. 将日志输出到文件

想要让日志输出到文件是很容易的， 只要指定filename即可。还可以指定encoding，如果不指定它，则使用open()函数的默认编码解码器。日志文件推荐使用.log而不是.txt后缀：

import logging

logging.basicConfig(
    level=logging.DEBUG,
    format='报告时间:%(asctime)s 报告等级:%(levelname)s; %(message)s',
    datefmt='%d日%H时%M分%S秒',
    filename='report.log'
)

logging.info('Hello')
logging.info('World!')
logging.info('I is ')

Python中logging模块用法示例总结

日志的写入方式默认是“a”，也就是向后追加。有时我们可能想让日志覆盖原来的内容，这时可以指定filemode更改写入方式，例如：

import logging

logging.basicConfig(
    level=logging.DEBUG,
    format='报告时间:%(asctime)s 报告等级:%(levelname)s; %(message)s',
    datefmt='%d日%H时%M分%S秒',
    filename='report.log',
    filemode='w'
)

logging.info('Hello')
logging.info('World!')
logging.info('I is ')

6. 屏蔽一些刷屏信息

有些模块在内部使用了logging，如果我们也导入使用logging就会触发它们的报告。比如，httpx会在请求成功时发送一条info日志，当我们配置logging后这些信息就可能出现：

import logging

import httpx

logging.basicConfig(
    level=logging.INFO,
    format='%(asctime)s-%(levelname)s; %(message)s',
    datefmt='%d日%H时%M分%S秒'
)

BASE_URL = 'https://www.httpbin.org/get'

def scrape(url):
    try:
        response = httpx.get(url)
    except httpx.RequestError:
        raise
    else:
        return response.text
    
from concurrent.futures import ThreadPoolExecutor

with ThreadPoolExecutor() as e:
    e.map(scrape, [BASE_URL for _ in range(10)])

Python中logging模块用法示例总结

可以看到，因为我指定level=logging.INFO，httpx的这些info日志就输出了。看着好烦人啊，如果我不想让它输出怎么办？ 

首先要找到“罪魁祸首”是谁，用getLogger获取这个日志记录器，再用setLevel方法更改它输出的最低日志等级即可。比如，下面在basicConfig下加了一条语句，阻止httpx刷屏。

import logging

import httpx

logging.basicConfig(
    level=logging.INFO,
    format='%(asctime)s-%(levelname)s; %(message)s',
    datefmt='%d日%H时%M分%S秒'
)
logging.getLogger('httpx').setLevel(logging.WARNING)

BASE_URL = 'https://www.httpbin.org/get'

def scrape(url):
    logging.info('开始访问%s', url)
    try:
        response = httpx.get(url)
    except httpx.RequestError:
        logging.critical('出错了!%s', url)
        raise
    else:
        logging.info('请求成功%s', url)
        return response.text
    
from concurrent.futures import ThreadPoolExecutor

with ThreadPoolExecutor() as e:
    e.map(scrape, [BASE_URL for _ in range(10)])

现在就只输出了我自己指定的信息：

Python中logging模块用法示例总结

二. 高级用法

掌握了上面的内容，就掌握了这个模块的精髓和核心，大部分情况下完全够用了。 

高级用法我就稍微说说吧，如果需要更详细China编程的指导请移步官方文档翻阅资料。 

之前说过， logging库有记录器、处理器、过滤器、格式器等组件。具体来说，每个记录器logger可以有多个处理器handler，而每个处理器又可以有自己的格式器formatter。过滤器给logger或handler提供了更详细的输出php细节，不过这里不谈论它。

为了帮读者专注于理解API的用法，而不是被混乱的命名弄乱，下面我将使用中文作为变量名。

1. 日志记录器

可以使用logging.Logger来指定记录器，推荐传入__name__参数作为它的名字。

import logging

记录器 = logging.Logger(__name__)

使用setLevel()方法可以控制它的日志等级，决定要将什么等级的日志传给处理器。

单独的记录器什么也做不到，需要和其它组件配合。

2. 日志处理器

处理器可以用来控制日志的输出方向。比如输出到终端和文件，分别对应下面两个常用的处理器类：

  • StreamHandler()
  • FileHandler()

 处理器也有setLevel()方法，用于筛选在从logger那里接收到的日志，决定发送哪些。

下面指定一个流处理器和一个文件处理器：

import logging

记录器 = logging.Logger(__name__)

流处理器 = logging.StreamHandler()
文件处理器 = logging.FileHandler('report.log', mode='w', encoding='utf-8')

3. 日志格式器

这个其实就是basicConfig的format参数的封装，作用是一样的。可以指定fmt和datefmt参数，例如：

import logging

记录器 = logging.Logger(__name__)

流处理器 = logging.StreamHandler()
文件处理器 = logging.FileHandler('report.log', mode='w', encoding='utf-8')

流格式器 = logging.Formatter(
    fmt='%(asctime)s-%(levelname)s; %(message)s',
    datefmt='时间:%H:%M:%S'
)
文件格式器 = logging.Formatter(
    fmt='%(asctime)s=%(levelname)s=%(name)s; %(message)s',
    datefmt='记录时间:%I:%M:%S,%p'
)

4. 拼接组件

下面拼接一下这些组件，就能让logger获取相应的功能。

首先，为处理器绑定格式器：

流处理器.setFormatter(流格式器)
文件处理器.setFormatter(文件格式器)

然后，为记录器绑定处理器：

记录器.setLevel(logging.INFO)
记录器.www.chinasem.cnaddHandler(流处理器)
记录器.addHandler(文件处理器)

 现在记录器就可以使用了。它会同时完成向终端和向文件输出的两个任务：

记录器.info('这是个信息')
记录器.warning('警告!没事没事')
记录器.error('错误!虽然我也不知道哪里错了')
记录器.critical('天塌了!我当被子盖')
记录器.info('纵有疾风起，人生不言弃')

Python中logging模块用法示例总结

Python中logging模块用法示例总结

完整代码：

import logging

记录器 = logging.Logger(__name__)

流处理器 = logging.StreamHandler()
文件处理器 = logging.FileHandler('report.log', mode='w', encoding='utf-8')

流格式器 = logging.Formatter(
    fmt='%(asctime)s-%(levelname)s; %(message)s',
    datefmt='时间:%H:%M:%S'
)
文件格式器 = logging.Formatter(
    fmt='%(asctime)s=%(levelname)s=%(name)s; %(message)s',
    datefmt='记录时间:%I:%M:%S,%p'
)

流处理器.setFormatter(流格式器)
文件处理器.setFormatter(文件格式器)

记录器.setLevel(logging.INFO)
记录器.addHandler(流处理器)
记录器.addHandler(文件处理器)

记录器.info('这是个信息')
记录器.warning('警告!没事没事')
记录器.error('错误!虽然我也不知道哪里错了')
记录器.critical('天塌了!我当被子盖')
记录器.info('纵有疾风起，人生不言弃')

 关于logging的高级用法，我们点到为止。有需求的同志可以去官方文档继续深造。

三. 总结

我们了解了一下logging模块的用法，对于高级用法点到为止了。这个模块相当强大，适用于想要跟踪程序行为的情况，可以使得捕获和修复错误更容易。它的上限远不止于此，欢迎同志们继续学习(*￣▽￣)~*

到此这篇关于Python中logging模块用法的文章就介绍到这了,更多相关Python logging模块用法内容请搜索编程China编程(www.chinasem.cn)以前的文章或继续浏览下面的相关文章希望大家以后多多支持China编程(www.chinasem.cn)！

这篇关于Python中logging模块用法示例总结的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/1155887。

相关文章

JDK21对虚拟线程的几种用法实践指南

JDK21对虚拟线程的几种用法实践指南

《JDK21对虚拟线程的几种用法实践指南》虚拟线程是Java中的一种轻量级线程,由JVM管理,特别适合于I/O密集型任务,：本文主要介绍JDK21对虚拟线程的几种用法,文中通过代码介绍的非常详细,... 目录一、参考官方文档二、什么是虚拟线程三、几种用法1、Thread.ofVirtual().start(
阅读更多...
详解SpringBoot+Ehcache使用示例

详解SpringBoot+Ehcache使用示例

《详解SpringBoot+Ehcache使用示例》本文介绍了SpringBoot中配置Ehcache、自定义get/set方式,并实际使用缓存的过程,文中通过示例代码介绍的非常详细,对大家的学习或者... 目录摘要概念内存与磁盘持久化存储：配置灵活性：编码示例引入依赖：配置ehcache.XML文件：配置
阅读更多...
Python版本信息获取方法详解与实战

Python版本信息获取方法详解与实战

《Python版本信息获取方法详解与实战》在Python开发中,获取Python版本号是调试、兼容性检查和版本控制的重要基础操作,本文详细介绍了如何使用sys和platform模块获取Python的主... 目录1. python版本号获取基础2. 使用sys模块获取版本信息2.1 sys模块概述2.1.1
阅读更多...
一文详解Python如何开发游戏

一文详解Python如何开发游戏

《一文详解Python如何开发游戏》Python是一种非常流行的编程语言,也可以用来开发游戏模组,：本文主要介绍Python如何开发游戏的相关资料,文中通过代码介绍的非常详细,需要的朋友可以参考下... 目录一、python简介二、Python 开发 2D 游戏的优劣势优势缺点三、Python 开发 3D
阅读更多...
Python函数作用域与闭包举例深度解析

Python函数作用域与闭包举例深度解析

《Python函数作用域与闭包举例深度解析》Python函数的作用域规则和闭包是编程中的关键概念,它们决定了变量的访问和生命周期,：本文主要介绍Python函数作用域与闭包的相关资料,文中通过代码... 目录1. 基础作用域访问示例1：访问全局变量示例2：访问外层函数变量2. 闭包基础示例3：简单闭包示例4
阅读更多...
Python实现字典转字符串的五种方法

Python实现字典转字符串的五种方法

《Python实现字典转字符串的五种方法》本文介绍了在Python中如何将字典数据结构转换为字符串格式的多种方法,首先可以通过内置的str()函数进行简单转换;其次利用ison.dumps()函数能够... 目录1、使用json模块的dumps方法：2、使用str方法：3、使用循环和字符串拼接：4、使用字符
阅读更多...
Python版本与package版本兼容性检查方法总结

Python版本与package版本兼容性检查方法总结

《Python版本与package版本兼容性检查方法总结》：本文主要介绍Python版本与package版本兼容性检查方法的相关资料,文中提供四种检查方法,分别是pip查询、conda管理、PyP... 目录引言为什么会出现兼容性问题方法一：用 pip 官方命令查询可用版本方法二：conda 管理包环境方法
阅读更多...
基于Python开发Windows自动更新控制工具

基于Python开发Windows自动更新控制工具

《基于Python开发Windows自动更新控制工具》在当今数字化时代,操作系统更新已成为计算机维护的重要组成部分,本文介绍一款基于Python和PyQt5的Windows自动更新控制工具,有需要的可... 目录设计原理与技术实现系统架构概述数学建模工具界面完整代码实现技术深度分析多层级控制理论服务层控制注
阅读更多...
pycharm跑python项目易出错的问题总结

pycharm跑python项目易出错的问题总结

《pycharm跑python项目易出错的问题总结》：本文主要介绍pycharm跑python项目易出错问题的相关资料,当你在PyCharm中运行Python程序时遇到报错,可以按照以下步骤进行排... 1. 一定不要在pycharm终端里面创建环境安装别人的项目子模块等，有可能出现的问题就是你不报错都安装
阅读更多...
Java高效实现PowerPoint转PDF的示例详解

Java高效实现PowerPoint转PDF的示例详解

《Java高效实现PowerPoint转PDF的示例详解》在日常开发或办公场景中,经常需要将PowerPoint演示文稿（PPT/PPTX）转换为PDF,本文将介绍从基础转换到高级设置的多种用法,大家... 目录为什么要将 PowerPoint 转换为 PDF安装 Spire.Presentation fo
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2