0

0

Python中如何实现日志记录?logging模块配置

星夢妙者

星夢妙者

发布时间:2025-07-16 18:13:02

|

463人浏览过

|

来源于php中文网

原创

python中推荐使用内置的logging模块实现日志记录,其核心在于模块化设计,包含logger、handler、formatter和filter四个组件。logging模块支持多种日志级别(debug、info、warning、error、critical),用于区分消息的重要性,控制日志输出的精细度。要同时将日志输出到控制台和文件,需为记录器添加多个处理器(streamhandler和filehandler),分别设置不同的日志级别和格式器,从而实现灵活的日志管理。

Python中如何实现日志记录?logging模块配置

Python中实现日志记录,最标准也最推荐的方式就是使用其内置的 logging 模块。它提供了一个强大且灵活的框架,让你能够精细地控制日志消息的级别、输出目的地(比如控制台、文件、网络)以及它们的格式。这远比简单的 print() 语句高效和专业,尤其是在你需要追踪程序运行状态、调试问题或进行审计时,日志系统是不可或缺的。它允许你将日志消息从生成、处理到最终输出的整个流程进行解耦,从而实现高度的可配置性。

Python中如何实现日志记录?logging模块配置

当你开始一个项目,特别是规模稍大一点的,日志记录绝对不是一个可有可无的选项。它就像是程序的“黑匣子”,在出现问题时能帮你快速定位。最基础的用法,你可能直接 print() 就完了,但那很快就会变得一团糟。logging 模块的精髓在于它的模块化设计,它把日志的生成、处理和输出分开了。

Python中如何实现日志记录?logging模块配置

一个日志系统通常由几个核心组件构成:

立即学习Python免费学习笔记(深入)”;

  • Logger(记录器): 这是你程序中产生日志消息的入口。你可以为不同的模块或功能创建不同的记录器,这样就能更细致地控制它们的日志行为。
  • Handler(处理器): 负责将日志消息发送到指定的位置,比如控制台、文件、网络甚至邮件。你可以给一个记录器添加多个处理器。
  • Formatter(格式器): 定义日志消息的输出格式,比如包含时间戳、日志级别、文件名等信息。
  • Filter(过滤器): 在日志消息被处理器处理之前,可以根据特定条件筛选消息。

最简单的日志记录可能就是这样:

Python中如何实现日志记录?logging模块配置
import logging

# 默认情况下,logging模块会输出到控制台,级别是WARNING及以上
logging.warning("这是一个警告信息,默认会被打印出来。")
logging.info("这是一个信息,默认不会被打印出来,因为级别低于WARNING。")

# 如果你想看到所有级别的日志,需要配置一下
# basicConfig 适合简单的脚本或应用启动时的快速配置
logging.basicConfig(level=logging.DEBUG,
                    format='%(asctime)s - %(levelname)s - %(message)s')
logging.debug("现在,调试信息也能看到了!")
logging.info("普通信息也能看到了。")
logging.error("哦,出错了!")

basicConfig 是一个快速设置根记录器的方法,适合简单的脚本。但实际项目中,你可能需要更精细的控制,比如为不同的模块设置不同的日志级别,或者将日志输出到多个地方。

Python日志记录中,不同日志级别有什么作用?

ModelGate
ModelGate

一站式AI模型管理与调用工具

下载

日志级别,说白了就是给日志消息打个“重要性标签”。这对于管理日志量,以及快速筛选出你真正关心的信息至关重要。我个人觉得,合理利用级别是日志管理的第一步,也是最容易被忽视的一步。它能帮助你区分哪些是调试细节,哪些是常规操作,哪些是需要立即关注的问题。

logging 模块提供了以下标准级别(从低到高):

  • DEBUG: 最详细的调试信息,通常只在开发阶段使用,用于追踪程序执行的每一步。比如,一个变量在某个点的具体值。
  • INFO: 程序正常运行时的信息,用于确认程序按预期工作。例如,“用户登录成功”、“数据处理完成”等,这些是业务流程中的关键节点。
  • WARNING: 发生了意料之外但程序仍能继续运行的情况。这通常意味着可能存在潜在问题,但还不至于导致功能失效,比如“配置文件未找到,使用默认设置”。
  • ERROR: 发生了比较严重的错误,导致某些功能无法正常执行,但程序可能不会崩溃。这通常需要开发人员介入检查。
  • CRITICAL: 发生了极其严重的错误,可能导致程序崩溃或无法继续运行,需要立即关注和处理。例如,数据库连接失败、关键服务不可用。

当一个记录器被设置为某个级别时,它只会处理该级别或更高级别的消息。例如,如果记录器级别是 INFO,那么 DEBUG 级别的消息就不会被处理。这就像一个过滤器,可以帮你过滤掉那些你暂时不关心的“噪音”,让你能专注于当前需要解决的问题。

如何将Python日志同时输出到控制台和文件?

在实际开发中,我们经常需要将日志既打印到控制台方便实时查看,又写入文件以便后续分析或审计。这在 logging 模块里实现起来非常直观,只需要给你的记录器添加多个处理器(Handler)就行了。这种多处理器配置是 logging 模块灵活性的一个典型体现。

我通常会这么做:先获取一个记录器实例,然后创建 StreamHandlerFileHandler,并把它们都添加到这个记录器上。别忘了给它们设置格式器,不然日志看起来会很乱,缺乏可读性。

import logging

# 1. 获取一个记录器实例,通常推荐使用模块名作为记录器名称
# 这样可以很方便地通过名称来管理和配置不同模块的日志
logger = logging.getLogger('my_app_logger') # 给记录器一个有意义的名字
logger.setLevel(logging.DEBUG) # 设置记录器的最低处理级别,这里是DEBUG,表示所有DEBUG及以上级别的日志都会被记录器处理

# 2. 创建一个StreamHandler,用于输出到控制台
console_handler = logging.StreamHandler()
console_handler.setLevel(logging.INFO) # 控制台只显示INFO及以上级别的日志,过滤掉DEBUG

# 3. 创建一个FileHandler,用于输出到文件
# 日志文件名为 'my_application.log'
file_handler = logging.FileHandler('my_application.log', encoding='utf-8')
file_handler.setLevel(logging.DEBUG) # 文件中记录所有DEBUG及以上级别的日志,方便详细追溯

# 4. 定义日志的输出格式
# 包括时间、记录器名称、日志级别、以及日志消息本身
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')

# 5. 为处理器设置格式器
console_handler.setFormatter(formatter)

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
python中print函数的用法
python中print函数的用法

python中print函数的语法是“print(value1, value2, ..., sep=' ', end=' ', file=sys.stdout, flush=False)”。本专题为大家提供print相关的文章、下载、课程内容,供大家免费下载体验。

193

2023.09.27

python print用法与作用
python print用法与作用

本专题整合了python print的用法、作用、函数功能相关内容,阅读专题下面的文章了解更多详细教程。

19

2026.02.03

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

492

2023.10.18

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

382

2023.10.25

数据库三范式
数据库三范式

数据库三范式是一种设计规范,用于规范化关系型数据库中的数据结构,它通过消除冗余数据、提高数据库性能和数据一致性,提供了一种有效的数据库设计方法。本专题提供数据库三范式相关的文章、下载和课程。

389

2023.06.29

如何删除数据库
如何删除数据库

删除数据库是指在MySQL中完全移除一个数据库及其所包含的所有数据和结构,作用包括:1、释放存储空间;2、确保数据的安全性;3、提高数据库的整体性能,加速查询和操作的执行速度。尽管删除数据库具有一些好处,但在执行任何删除操作之前,务必谨慎操作,并备份重要的数据。删除数据库将永久性地删除所有相关数据和结构,无法回滚。

2111

2023.08.14

vb怎么连接数据库
vb怎么连接数据库

在VB中,连接数据库通常使用ADO(ActiveX 数据对象)或 DAO(Data Access Objects)这两个技术来实现:1、引入ADO库;2、创建ADO连接对象;3、配置连接字符串;4、打开连接;5、执行SQL语句;6、处理查询结果;7、关闭连接即可。

357

2023.08.31

MySQL恢复数据库
MySQL恢复数据库

MySQL恢复数据库的方法有使用物理备份恢复、使用逻辑备份恢复、使用二进制日志恢复和使用数据库复制进行恢复等。本专题为大家提供MySQL数据库相关的文章、下载、课程内容,供大家免费下载体验。

259

2023.09.05

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

26

2026.03.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.5万人学习

Django 教程
Django 教程

共28课时 | 5万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号