快捷導(dǎo)航

python basicConfig()簡介及用法舉例

更新時間：2025年08月12日 10:47:03 作者：貴哥的編程之路

logging.basicConfig() 是 Python logging 模塊中最常用的配置函數(shù),用于一次性設(shè)置日志系統(tǒng)的基本參數(shù)（如日志級別、輸出格式、輸出位置等）,本文給大家介紹python basicConfig()簡介及用法舉例,感興趣的朋友一起看看吧

一、什么是basicConfig？

logging.basicConfig() 是 Python logging 模塊中最常用的配置函數(shù)，用于一次性設(shè)置日志系統(tǒng)的基本參數(shù)（如日志級別、輸出格式、輸出位置等）。
只需調(diào)用一次，后續(xù)所有日志輸出都會遵循這個配置。

二、basicConfig的常用參數(shù)

參數(shù)	作用說明	示例值
level	設(shè)置日志級別（只顯示大于等于該級別的日志）	logging.INFO, logging.DEBUG
filename	指定日志輸出到的文件名（不指定則輸出到控制臺）	‘app.log’
filemode	文件寫入模式，默認為 ‘a’（追加），可設(shè)為 ‘w’（覆蓋）	‘w’
format	日志輸出格式字符串	‘%(asctime)s - %(levelname)s - %(message)s’
datefmt	時間格式字符串	‘%Y-%m-%d %H:%M:%S’
encoding	文件編碼（僅當(dāng)指定 filename 時有效）	‘utf-8’

三、默認行為

如果不調(diào)用 basicConfig()，日志系統(tǒng)有默認配置：
- 日志級別為 WARNING，只顯示 WARNING 及以上級別的日志。
- 日志輸出到控制臺。
- 日志格式為：LEVEL:logger_name:message，如：WARNING:root:demo
如果調(diào)用 basicConfig() 但不傳參數(shù)，效果與默認配置一致。

四、你的代碼詳解

示例1

import logging
# logging.basicConfig()
logging.warning('demo')

這里沒有調(diào)用 basicConfig()，直接輸出一條警告日志。
輸出結(jié)果：WARNING:root:demo
只會顯示 WARNING 及以上級別的日志。

示例2

import logging
logging.basicConfig()  # 日志格式：格式字符
logging.warning('demo')

這里調(diào)用了 basicConfig()，但沒有傳參數(shù)，效果與默認配置一致。
輸出結(jié)果同上：WARNING:root:demo

五、常見用法舉例

1. 設(shè)置日志級別

logging.basicConfig(level=logging.INFO)
logging.debug('調(diào)試信息')   # 不會顯示
logging.info('普通信息')   # 會顯示

2. 設(shè)置日志格式

logging.basicConfig(
    level=logging.DEBUG,
    format='%(asctime)s - %(levelname)s - %(message)s'
)
logging.info('日志格式演示')

輸出示例：

2024-06-08 12:00:00,123 - INFO - 日志格式演示

3. 日志寫入文件

logging.basicConfig(
    filename='myapp.log',
    level=logging.ERROR,
    format='%(asctime)s - %(levelname)s - %(message)s',
    encoding='utf-8'
)
logging.error('寫入文件的錯誤日志')

六、常用格式化符號

占位符	說明
%(asctime)s	日志時間
%(levelname)s	日志級別
%(message)s	日志內(nèi)容
%(filename)s	文件名
%(lineno)d	行號
%(name)s	日志器名稱
%(thread)d	線程ID