合理的日誌配置能提升問題定位和系統(tǒng)監(jiān)控效率。 1. 設(shè)置日誌級別：開發(fā)時(shí)用DEBUG，生產(chǎn)環(huán)境用INFO或WARNING，便於控制輸出粒度；2. 使用logger實(shí)例代替直接調(diào)用logging.xxx()，實(shí)現(xiàn)模塊化管理和細(xì)粒度控制；3. 添加多個(gè)Handler（如StreamHandler、FileHandler）將日誌輸出到不同目的地並按需設(shè)置級別；4. 定義包含時(shí)間戳、級別、模塊名等信息的格式化內(nèi)容，提升日誌可讀性和分析效率。

在Python 項(xiàng)目中，合理的日誌配置和使用方式能讓你快速定位問題、了解程序運(yùn)行狀態(tài)，甚至幫助你優(yōu)化性能。很多人一開始只是隨便用print()輸出信息，但當(dāng)項(xiàng)目變大、部署上線之後，這種方式就顯得非常無力。正確的做法是用好Python 內(nèi)置的logging模塊，它功能強(qiáng)大且靈活。

下面是一些實(shí)用建議和配置方式，適合大多數(shù)實(shí)際場景。

日誌級別設(shè)置要合理

Python 的logging模塊支持多個(gè)日誌級別：DEBUG、INFO、WARNING、ERROR、CRITICAL。每個(gè)級別代表不同的嚴(yán)重程度。如果你只輸出ERROR 級別的日誌，那在排查問題時(shí)可能缺少上下文；如果全都輸出DEBUG，又容易被信息淹沒。

建議：

• 開發(fā)階段設(shè)置為DEBUG，全面記錄。
• 生產(chǎn)環(huán)境默認(rèn)設(shè)為INFO 或WARNING，只記錄關(guān)鍵流程和異常。
• 出現(xiàn)問題時(shí)，可以臨時(shí)調(diào)低日誌級別來獲取更多信息。

 import logging
logging.basicConfig(level=logging.INFO)

這樣設(shè)置後，INFO 及以上級別的日誌都會(huì)被處理，DEBUG 級別則會(huì)被忽略。

使用logger 而不是直接調(diào)用logging.xxx()

很多人習(xí)慣寫logging.info("xxx") ，但這樣做其實(shí)不太規(guī)範(fàn)。推薦的做法是創(chuàng)建一個(gè)logger 實(shí)例：

 logger = logging.getLogger(__name__)
logger.info("This is an info message.")

好處有幾個(gè)：

• 每個(gè)模塊都可以有自己的logger，方便做細(xì)粒度控制。
• 更容易統(tǒng)一命名和管理。
• 在不同層級設(shè)置不同的日誌級別或處理器（handler）會(huì)更清晰。

比如你可以給某個(gè)特定模塊設(shè)置更高的日誌級別，而不影響全局配置。

添加多個(gè)Handler 來區(qū)分輸出目的地

有時(shí)候我們希望把日誌輸出到控制臺(tái)的同時(shí)也寫入文件，或者發(fā)送到遠(yuǎn)程服務(wù)。這時(shí)候就可以添加多個(gè)handler。

常見的組合包括：

• 控制臺(tái)輸出（StreamHandler）
• 文件記錄（FileHandler 或RotatingFileHandler）
• 郵件通知（SMTPHandler，用於錯(cuò)誤級別）

示例代碼：

 logger = logging.getLogger(__name__)
logger.setLevel(logging.DEBUG)

# 控制臺(tái)輸出console_handler = logging.StreamHandler()
console_handler.setLevel(logging.INFO)
console_formatter = logging.Formatter('%(asctime)s - %(levelname)s - %(message)s')
console_handler.setFormatter(console_formatter)

# 文件記錄file_handler = logging.FileHandler('app.log')
file_handler.setLevel(logging.DEBUG)
file_formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
file_handler.setFormatter(file_formatter)

logger.addHandler(console_handler)
logger.addHandler(file_handler)

這樣，INFO 及以上信息會(huì)在控制臺(tái)顯示，DEBUG 及以上會(huì)被寫入文件，互不影響。

格式化日誌內(nèi)容要有重點(diǎn)信息

日誌格式不建議太簡單，否則後續(xù)分析起來很麻煩。至少應(yīng)該包含時(shí)間戳、日誌級別、模塊名和消息內(nèi)容。

常見字段說明：

• %(asctime)s ：時(shí)間戳
• %(levelname)s ：日誌級別名稱
• %(name)s ：logger 名稱
• %(message)s ：日誌內(nèi)容
• %(lineno)d ：行號(hào)（調(diào)試時(shí)有用）

例如：

 formatter = logging.Formatter('%(asctime)s [%(levelname)s] %(name)s:%(lineno)d - %(message)s')

這樣輸出的日誌信息更完整，便於查找和分析。

基本上就這些。
logging 是一個(gè)看似簡單但很容易用錯(cuò)的部分，尤其是在多模塊、多線程環(huán)境下。只要記住幾個(gè)基本原則：按需設(shè)置級別、使用logger 對象、分開輸出渠道、格式清晰，就能滿足大部分需求了。

以上是Python中有效的記錄配置和使用的詳細(xì)內(nèi)容。更多資訊請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！