合理的日志配置能提升問題定位和系統(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ī)范。推薦的做法是創(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í)候我們希望把日志輸出到控制臺的同時(shí)也寫入文件，或者發(fā)送到遠(yuǎn)程服務(wù)。這時(shí)候就可以添加多個(gè) handler。

常見的組合包括：

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

示例代碼：

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

# 控制臺輸出
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ì)在控制臺顯示，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：行號（調(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)文章！