python Logging 模塊是一個強大的工具，用于處理日志消息和事件。它提供了豐富的功能，可幫助您記錄和監視應用程序的行為。本指南將帶您從初級用戶到高級用戶，介紹 Python Logging 模塊的方方面面。

設置日志記錄

第一步是設置日志記錄。為此，您需要導入 logging 模塊并創建一個 Logger 對象。Logger 對象負責接收日志消息并將其傳遞給處理程序。

import logging

# 創建一個 Logger 對象
logger = logging.getLogger("my_app")

# 設置日志級別
logger.setLevel(logging.DEBUG)

日志級別

日志級別確定要記錄哪些消息。Python Logging 模塊定義了幾個標準級別：

DEBUG：詳細調試信息
INFO：一般性信息消息
WARNING：潛在錯誤或問題
ERROR：錯誤或異常
CRITICAL：嚴重的錯誤或應用程序崩潰

處理程序

處理程序負責將日志消息發送到不同的目的地，例如文件、控制臺或遠程服務器。您可以使用以下處理程序：

# 將日志消息發送到控制臺
console_handler = logging.StreamHandler()

# 將日志消息發送到文件
file_handler = logging.FileHandler("my_app.log")

格式化程序

格式化程序用于自定義日志消息的外觀。它允許您指定日志消息的格式，包括時間戳、日志級別、消息文本等。

# 創建一個簡單的格式化程序
fORMatter = logging.Formatter("%(asctime)s - %(levelname)s - %(message)s")

# 將格式化程序附加到處理程序
console_handler.setFormatter(formatter)

使用 Logger

設置日志記錄后，您可以使用 Logger 對象記錄消息：

logger.debug("This is a debug message.")
logger.info("This is an info message.")
logger.warning("This is a warning message.")

高級用法

除了基本功能外，Python Logging 模塊還提供了許多高級功能，例如：

父/子 Logger：創建層次結構的 Logger，其中子 Logger 可以繼承父 Logger 的級別和處理程序。
過濾：使用過濾器來控制要記錄的日志消息。
自定義級別：創建自己的日志級別，以滿足特定應用程序需求。
多處理：在多進程或多線程應用程序中使用 Logging。

示例

以下示例展示了如何使用 Python Logging 模塊記錄應用程序日志：

import logging

# 設置日志記錄
logging.basicConfig(level=logging.INFO,
format="%(asctime)s - %(levelname)s - %(message)s",
handlers=[logging.StreamHandler()])

# 創建一個 Logger 對象
logger = logging.getLogger("my_app")

# 記錄日志消息
logger.info("Application started")
logger.warning("An error occurred")

通過遵循本指南，您可以掌握 Python Logging 模塊，并為您的應用程序創建有效且可擴展的日志記錄系統。