Python logging 日志级别调整与输出配置指南

季宁
季宁
发布时间:2026-10-11| 1人浏览过
原创

本文详细介绍 Python 标准库 logging 模块的日志级别调整方法。默认情况下,logging 仅输出 WARNING 及以上级别的日志。通过调用 logging.basicConfig() 函数,可以灵活配置日志级别(如 DEBUG、INFO 等)以及输出目标(控制台或指定文件)。文章提供了具体的代码示例,演示如何开启所有日志输出以及如何将日志写入文件。

Python logging 日志级别调整方式

在 Python 开发中,日志记录是调试和监控应用状态的重要手段。Python 内置的 logging 模块提供了灵活的日志记录功能。默认情况下,logging 模块的日志级别被设置为 WARNING。这意味着,只有 WARNING、ERROR 和 CRITICAL 级别的日志消息会被输出到控制台,而 DEBUG 和 INFO 级别的日志会被忽略。

默认行为演示

为了直观理解默认行为,我们可以尝试记录不同级别的日志消息。以下代码展示了如何记录从 DEBUG 到 CRITICAL 的五种标准日志级别:

import logging

logging.debug('debug message')
logging.info('info message')
logging.warn('warn message')
logging.error('error message')
logging.critical('critical message')

运行上述代码后,控制台仅会输出 WARNING 级别及以上的消息:

WARNING:root:warn message
ERROR:root:error message
CRITICAL:root:critical message

调整日志级别至 DEBUG

如果在开发过程中需要查看更详细的调试信息(如变量状态、程序执行流程等),可以将日志级别调整为 DEBUG。这可以通过调用 logging.basicConfig() 函数并指定 level 参数来实现。将级别设置为 logging.DEBUG 后,所有日志消息(包括 DEBUG 和 INFO)都将在控制台输出。

具体实现代码如下:

import logging

logging.basicConfig(level=logging.DEBUG)

logging.debug('debug message')
logging.info('info message')
logging.warn('warn message')
logging.error('error message')
logging.critical('critical message')

执行该代码后,控制台将输出所有级别的日志消息:

DEBUG:root:debug message
INFO:root:info message
WARNING:root:warn message
ERROR:root:error message
CRITICAL:root:critical message

将日志输出到文件

除了调整日志级别,我们通常还需要将日志持久化保存,以便后续分析。通过 logging.basicConfig() 函数的 filename 参数,可以指定日志输出的目标文件。当指定了文件名后,日志将不再输出到控制台,而是写入到指定的文件中。

例如,将日志输出到名为 test.log 的文件中,并记录所有级别的日志:

import logging

logging.basicConfig(filename='test.log', level=logging.DEBUG)

logging.debug('debug message')
logging.info('info message')
logging.warn('warn message')
logging.error('error message')
logging.critical('critical message')

运行上述代码后,控制台将没有任何输出。此时,检查当前目录下的 test.log 文件,可以看到所有级别的日志消息已被成功写入该文件。这种方式在需要长期监控应用状态或排查线上问题时非常有用。

以上就是 Python logging 日志级别调整与输出配置的详细内容,更多关于 Python 日志模块的资料请关注本站其它相关文章!

相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。