新闻中心

Python代码怎样进行日志记录 Python代码使用Logging模块的配置

2025-11-10
浏览次数:
返回列表
最推荐的方式是使用Python内置的logging模块,它通过Logger、Handler、Formatter组件实现灵活的日志分级、格式化和多目标输出,远优于print()。

python代码怎样进行日志记录 python代码使用logging模块的配置

Python代码进行日志记录最推荐且最灵活的方式是使用其内置的 logging 模块。它提供了一个强大且高度可配置的框架,能够有效地捕获、分类和输出日志消息到各种目标,从而在调试、监控和审计方面远优于简单的 print() 语句。

当谈到Python代码的日志记录,我个人觉得,跳过那些简单的 print() 语句直接拥抱 logging 模块,是每一个稍微复杂点项目都应该做的。它不仅仅是把信息打印出来,更是一个完整的体系,能让你精细地控制什么信息在什么时候、以什么格式、发送到哪里。

核心思想是:你创建 Logger 对象,然后往里面发消息。这些消息带着不同的级别(DEBUG, INFO, WARNING, ERROR, CRITICAL),表示它们的严重程度。Logger 不会直接处理这些消息,而是把它们交给 Handler。Handler 决定消息去哪里,比如控制台、文件、网络。Formatter 则负责把消息格式化成你想要的样子。

一个基本的配置流程大概是这样:

  1. 获取 Logger 实例: 通常用 logging.getLogger(__name__)__name__ 会让每个模块拥有自己的 Logger,便于追踪日志来源。
  2. 设置 Logger 级别: logger.setLevel(logging.DEBUG) 决定了该 Logger 会处理哪个级别及以上的所有消息。
  3. 创建 Handler: 比如 StreamHandler 用于控制台输出,FileHandler 用于文件。
  4. 设置 Handler 级别: handler.setLevel(logging.INFO)。注意,Logger 和 Handler 都有级别,只有当消息的级别高于 Logger 和 Handler 的最低级别时,它才会被处理。
  5. 创建 Formatter: 定义日志消息的格式,比如时间戳、级别、消息内容等。
  6. 将 Formatter 添加到 Handler: handler.setFormatter(formatter)
  7. 将 Handler 添加到 Logger: logger.addHandler(handler)
import logging

# 1. 获取 Logger 实例
# 推荐使用 __name__,这样日志中会显示模块名
logger = logging.getLogger(__name__) 
logger.setLevel(logging.DEBUG) # 设置Logger的最低处理级别

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

# 3. 创建一个 FileHandler,用于输出到文件
# 'app.log' 是日志文件名,'a' 表示追加模式
file_handler = logging.FileHandler('app.log', mode='a', encoding='utf-8')
file_handler.setLevel(logging.DEBUG) # 文件记录所有DEBUG及以上级别

# 4. 创建 Formatter
# 定义日志消息的格式
formatter = logging.Formatter(
    '%(asctime)s - %(name)s - %(levelname)s - %(message)s',
    datefmt='%Y-%m-%d %H:%M:%S'
)

# 5. 将 Formatter 添加到 Handler
console_handler.setFormatter(formatter)
file_handler.setFormatter(formatter)

# 6. 将 Handler 添加到 Logger
logger.addHandler(console_handler)
logger.addHandler(file_handler)

# 7. 记录日志
logger.debug("这是一个调试信息,只会在文件中出现。")
logger.info("这是一个普通信息,控制台和文件都会出现。")
logger.warning("这是一个警告信息。")
logger.error("这是一个错误信息。")
logger.critical("这是一个严重错误,程序可能无法继续。")

# 尝试在另一个模块中记录
# 模拟在另一个文件里
def another_function():
    # 获取同一个logger实例,但它的名字是'another_module'
    # 如果没有配置'another_module'的logger,它会使用root logger或者父logger的配置
    # 更好的做法是在每个模块都获取并配置自己的logger,或者统一配置
    another_logger = logging.getLogger('another_module') 
    another_logger.info("这是来自另一个模块的信息。")

another_function()

这段代码展示了最基础的配置,但它已经能解决大部分场景了。你会发现,调试信息(DEBUG)只会写入文件,而不会污染控制台,这在开发和生产环境中非常有用。

为什么我们不应该只用 print() 来调试和记录日志?

这真是一个老生常谈的问题,但每次看到项目里充斥着 print() 语句,我都会忍不住想,这背后的成本到底有多大。 print() 最大的问题在于它太“原始”了。你没办法控制它的输出级别,不能说“生产环境只看错误,开发环境看所有”。它没有时间戳,没有模块来源,更不能方便地输出到文件或者其他系统。

想象一下,一个线上服务突然出了问题,你唯一的线索是散落在代码各处的 print() 输出。你得手动去改代码,添加更多的 print(),然后重新部署,这简直是噩梦。而且, print() 默认是输出到标准输出的,如果你的程序崩溃了,或者被守护进程托管了,这些信息可能就直接丢失了。

Yaara Yaara

使用AI生成一流的文案广告,电子邮件,网站,列表,博客,故事和更多…

Yaara 95 查看详情 Yaara

logging 模块则完全不同。它是一个成熟的框架,允许你:

  • 分级管理: DEBUG, INFO, WARNING, ERROR, CRITICAL,一目了然,方便过滤。
  • 灵活输出: 可以同时输出到控制台、文件、网络、邮件等。
  • 格式化: 日志消息可以包含时间、模块名、文件名、行号、函数名、进程ID、线程ID等丰富上下文信息。
  • 性能考量: 生产环境中可以轻易关闭低级别的日志,减少IO开销。
  • 可维护性: 统一的日志接口,便于后期维护和故障排查。

所以,放弃 print() 吧,拥抱 logging 带来的便利和专业性,这会让你在项目维护上省下大量的时间和精力。这不仅仅是代码规范的问题,更是工程化思维的一种体现。

如何通过配置文件来管理 logging 模块的复杂配置?

直接在代码里写 logging 配置,对于小项目来说确实很直观,但当你的项目模块越来越多,日志需求越来越复杂(比如不同的模块需要不同的日志级别,或者需要输出到不同的文件),硬编码就会变得非常笨重且难以维护。这时候,通过配置文件来管理 logging 配置就显得尤为重要了。

logging 模块支持多种配置文件格式,最常用的是 dictConfig(字典配置)和 fileConfig(INI格式文件配置)。我个人更偏爱 dictConfig,因为它直接用Python字典来描述配置,与Python代码天然契合,也更具表现力。

使用 dictConfig 的基本步骤是:

  1. 定义一个Python字典,包含 version, formatters, handlers, loggers, root 等键。
  2. 调用 logging.config.dictConfig() 函数,传入这个字典。

下面是一个使用 dictConfig 的例子,它配置了一个名为 my_app 的 Logger,将 DEBUG 级别及以上的日志输出到控制台,同时将 INFO 级别及以上的日志写入一个滚动文件(每天生成一个新文件,保留7天):

import logging.config
import logging
import os

# 定义日志配置字典
LOGGING_CONFIG = {
    'version': 1, # 配置版本,必须是1
    'disable_existing_loggers': False, #

以上就是Python代码怎样进行日志记录 Python代码使用Logging模块的配置的详细内容,更多请关注其它相关文章!


# python  # 蛮便宜网站建设游戏  # 学校招标网站建设  # 如何推广彩信营销  # seo基础入门视频  # 的是  # 中非  # 创建一个  # 行号  # 仅仅是  # 这是  # 自己的  # python代码  # 编码  # app  # stream  # 配置文件  # 代码规范  # 开发环境  # 为什么  # 这是一个  # 是一个  # 广安微信端网站建设报价  # seo采集技巧  # 楚雄营销推广咨询招聘网  # seo做博客怎么规划  # 海南seo优化热线  # 大冶seo对比 


相关栏目: 【 科技资讯46185 】 【 网络学院92790


相关推荐: Angular响应式表单:实现提交后表单及按钮的禁用与只读化  ArrayList与LinkedList操作复杂度详解:遍历与修改  为什么我的微信朋友圈看不到别人的更新_微信朋友圈更新显示异常解决方法  poki免费入口快捷访问 poki人气小游戏直接玩站点  J*a实现学校排课程序_面向对象结构化项目示例  绝地鸭卫平a核爆刀流玩法攻略  微博网页版官方账号登录 微博网页版内容浏览使用指南  PyTorch模型训练效果不佳?深入剖析常见错误与调试技巧  Go调试环境为何无法启动_Go调试器启动失败原因与解决策略  Win11怎么用U盘重装系统 Win11制作启动盘并重装系统完整教程【详解】  天猫双十一预售商品怎么退款_天猫双十一预售退款操作指南  海量存储:机器视觉智能化的核心基石  小红书网页版入口链接分享 小红书官网直接进  Golang如何优化内存分配与垃圾回收_Golang内存管理与GC优化实践  NVIDIA股价11月重挫12%:下月有望好转 但难回5万亿美元巅峰  Descript怎样用AI剪辑自动去噪_Descript用AI剪辑自动去噪【自动降噪】  手机CPU怎么影响游戏体验_手机CPU对游戏性能的影响分析  迅雷下载到U盘速度很慢怎么办_迅雷U盘下载慢优化方法  地铁跑酷免费秒玩入口链接 地铁跑酷小游戏免费秒玩网站  解决macOS Tkinter应用双击启动崩溃:PyInstaller打包指南  如何更改在 Excel 中打开超链接时的默认浏览器  Win10如何清理注册表垃圾 Win10手动清理无效注册表【技巧】  飞书妙记怎样用语音转文字速记_飞书妙记用语音转文字速记【速记方法】  QQ邮箱在线使用入口 QQ邮箱个人账号网页版登录  解决 Vaadin 8 中大文件音频播放与定位时出现的 IOException  期待已久:小米17 Ultra、小米首款NAS本月登场  漫蛙Manwa2官网入口地址分享 漫蛙漫画PC版永久访问通道  HTML空白字符处理机制:渲染、DOM与编码实践  Golang指针如何与map组合使用_Golang map指针组合实践  极兔快递快件信息查询系统 极兔快递官网运单号追踪  照顾宝贝2小游戏免费秒玩入口  Basecamp怎样用留言钉固定重点_Basecamp用留言钉固定重点【重点标记】  如何将HTML表格多行数据保存到Google Sheets  淘宝网网页版登录入口 淘宝官方网页版快捷登录  PHP 枚举:根据字符串获取枚举案例的策略与实现  ArrayList与LinkedList核心操作的Big-O复杂度分析  构建轻量级网站内部消息系统:Formspree 集成指南  Win10如何清理注册表垃圾 Win10注册表维护与优化指南【慎用】  动漫共和国防屏蔽稳定域名-动漫共和国官方正版直达通道  漫蛙2(台版)官方入口地址 漫蛙2(台版)正版漫画网页端  优化Log4j2控制台输出性能:解决异步日志瓶颈  QQ邮箱网页版登录入口 QQ邮箱官方在线使用平台  CSS Flexbox如何实现多行排列_flex-wrap wrap自动换行显示  处理动态列数据:J*a ArrayList的正确初始化与字符累加教程  Python异步编程实践:使用Binance API构建实时交易数据流  J*aScript中针对特定容器内图片动画的实现教程  C++如何实现异步操作_C++11使用std::future和std::async进行异步编程  抖音网页版企业服务中心登录入口_抖音网页版企业登录平台  Composer的 "conflict" 字段有什么用_如何声明不兼容的包以避免依赖冲突  J*aScript中向JSON对象添加新属性的正确姿势 

搜索