Python學習之日志模塊詳解

更新時間：2022年03月28日 09:03:48 作者：渴望力量的哈士奇

說到日志，我們完全可以想象為現(xiàn)實生活中的日記。日記是我們平時記錄我們生活中點點滴滴的一種方法，而日志我們可以認為是程序的日記，程序的日記是用來記錄程序的行為。本文將詳細介紹Python中的日志模塊(logging)，需要的可以參考一下

日志的作用

說到日志，我們完全可以想象為現(xiàn)實生活中的日記。日記是我們平時記錄我們生活中點點滴滴的一種方法，而日志我們可以認為是程序的日記，程序的日記是用來記錄程序的行為，一般來說我們可以通過日志記錄一些程序的重要信息。

比如哪里報錯了？報錯原因是什么？這個時候我們就可以通過查看日志知道哪里出了什么錯誤，并且是什么原因造成的，這樣就可以幫助我們快速查錯并修復bug。

其實并不僅僅是錯誤的信息，我們還可以通過日志記錄程序運行的狀態(tài)。

日志的等級

既然明確了日志的作用，在平時的日志記錄過程中我們可以根據(jù)自己不同的業(yè)務需要進行不同等級的日志的記錄。

debug：可以幫助我們在平時的開發(fā)過程中，幫助我們查看一些輸出的信息是否正確。它可以替代我們平時使用的 print() 函數(shù)。

info：它代表了一般的消息類信息，只是為了記錄一些程序的行為，比如程序執(zhí)行到了某個位置，進行一些簡單的記錄。

warnning：該等級是一種警告，一般來說程序不會出錯，但是可能存在一定的潛在風險。

error：一般對應業(yè)務中出現(xiàn)了重大問題。比如異?；蛘邩I(yè)務邏輯不應該執(zhí)行到某種情況。我們都可以通過error來進行記錄。

critical：比 error 更嚴重的級別，不過一般來說 error 級別已經(jīng)很嚴重了，所以 critical 很少使用。

logging 模塊的使用

其實 logging 模塊使用起來還是比較復雜的，不過我們初學乍道，只需要學習使用 logging.basicConfig 就可以滿足我們最基本的日志記錄功能。

接下來我們看一下 logging.basicConfig 需要傳入哪些參數(shù)以及如何使用。

參數(shù)名	作用	舉例
lever	日志輸出的最低等級	lever=logging.DEBUG
format	日志輸出格式	見下文的 format 具體格式
filename	存儲位置	filename=‘d://debug.log’
filemode	輸入模式	filemode=“w”

關(guān)于 lever ，lerver的作用是表示最低的日志等級記錄。如上文中的 lever=logging.DEBUG ，就表示記錄包含 DEBUG 級別在內(nèi)的所有日志等級。

format具體格式如下：

格式符	含義
%(levername)s	日志級別名稱
%(pathname)s	當前執(zhí)行程序的路徑(即腳本所在的位置)
%(filename)s	執(zhí)行腳本程序名
%(lineno)d	日志當前的行號
%(asctime)s	打印日志的時間
%(message)s	日志信息

常用的日志 fromat 常用方案：fromat = '%(asctime)s %(filename)s[line:%(lineno)d] %(levername)s %(message)s'

logging 模塊演示小案例

import logging


logging.basicConfig(        # 針對 basicConfig 進行配置(basicConfig 其實就是對 logging 模塊進行動態(tài)的調(diào)整，之后可以直接使用)
    level=logging.INFO,     # INFO 等級以下的日志不會被記錄
    format='%(asctime)s %(filename)s[line:%(lineno)d] %(levelname)s %(message)s',    # 日志輸出格式
    filename='back.log',    # 日志存放路徑(存放在當前相對路徑)
    filemode='w',           # 輸入模式；如果當前我們文件已經(jīng)存在，可以使用 'a' 模式替代 'w' 模式
                            # 與文件寫入的模式相似，'w' 模式為沒有文件時創(chuàng)建文件；'a' 模式為追加內(nèi)容寫入日志文件
)


logging.debug('這是一條 debug 信息')
logging.info('這是一條 日志記錄 信息')
logging.warning('這是一條 警告 信息')
logging.error('這是一條 重大的錯誤 信息')

# >>> 執(zhí)行結(jié)果如下圖

上面我們使用的 filemode 模式是 'w' 模式，現(xiàn)在我們改為 'a' 模式，嘗試將日志追加進入 back.log 文件。

import logging


logging.basicConfig(        # 針對 basicConfig 進行配置(basicConfig 其實就是對 logging 模塊進行動態(tài)的調(diào)整，之后可以直接使用)
    level=logging.INFO,     # INFO 等級以下的日志不會被記錄
    format='%(asctime)s %(filename)s[line:%(lineno)d] %(levelname)s %(message)s',    # 日志輸出格式
    filename='back.log',    # 日志存放路徑(存放在當前相對路徑)
    filemode='a',           # 輸入模式；如果當前我們文件已經(jīng)存在，可以使用 'a' 模式替代 'w' 模式
                            # 與文件寫入的模式相似，'w' 模式為沒有文件時創(chuàng)建文件；'a' 模式為追加內(nèi)容寫入日志文件
)


logging.debug('這是一條 debug 信息 ---> \'a\' 模式第二次寫入')
logging.info('這是一條 日志記錄 信息 ---> \'a\' 模式第二次寫入')
logging.warning('這是一條 警告 信息 ---> \'a\' 模式第二次寫入')
logging.error('這是一條 重大的錯誤 信息 ---> \'a\' 模式第二次寫入')

# >>> 執(zhí)行結(jié)果如下圖

這里關(guān)于文件是否存在，使用 ‘w’ 模式還是 ‘a’ 模式，我們完全可以通過 os 模塊進行路徑文件的判斷，所以我們針對上文的腳本再進行優(yōu)化一下。

import logging
import os

def init_log(path):
    if os.path.exists(path):
        mode = 'a'
    else:
        mode = 'w'
    logging.basicConfig(        # 針對 basicConfig 進行配置(basicConfig 其實就是對 logging 模塊進行動態(tài)的調(diào)整，之后可以直接使用)
        level=logging.INFO,     # INFO 等級以下的日志不會被記錄
        format='%(asctime)s %(filename)s[line:%(lineno)d] %(levelname)s %(message)s',    # 日志輸出格式
        filename='back.log',    # 日志存放路徑(存放在當前相對路徑)
        filemode=mode,          # 輸入模式；如果當前我們文件已經(jīng)存在，可以使用 'a' 模式替代 'w' 模式
                                # 與文件寫入的模式相似，'w' 模式為沒有文件時創(chuàng)建文件；'a' 模式為追加內(nèi)容寫入日志文件
    )

    return logging


current_path = os.getcwd()
path = os.path.join(current_path, 'back.log')

log = init_log(path)        # 初始化返回的 init_log() 函數(shù) , 其實就是 return logging


log.debug('這是一條 debug 信息 ---> 第三次寫入')
log.info('這是一條 日志記錄 信息 ---> 第三次寫入')
log.warning('這是一條 警告 信息 ---> 第三次寫入')
log.error('這是一條 重大的錯誤 信息 ---> 第三次寫入')

# >>> 執(zhí)行結(jié)果如下圖：