Python 日誌記錄：loguru 與日誌記錄-Python教學-PHP中文網

Python 日誌庫對比：logging vs loguru

1. Loguru 簡化日誌記錄

Python Logging: loguru vs logging

在 Python 開發中，日誌記錄是一個至關重要的工具。它幫助開發者記錄程式運作狀態、調試問題以及監控系統健康狀況。 Python 自備 logging 函式庫。然而，隨著需求變化，許多人開始使用 loguru 作為替代方案。本文將比較這兩個函式庫，幫助您選擇更合適的日誌記錄解決方案。

Loguru 是一個流行的第三方日誌記錄庫。它透過簡化配置過程、支援鍊式呼叫以及提供更豐富的功能，成為 logging 的有力替代品。

Loguru 的優勢

簡單的設定: Loguru 不需要建立複雜的設定。只需幾行程式碼即可完成複雜的日誌配置。
鍊式調用: 它支援鍊式調用，使日誌記錄更直觀。
多目標輸出: 它可以輕鬆實現同時向控制台和文件輸出日誌，並且支援豐富的格式配置。
額外功能: 它支援自動日誌壓縮、日誌檔案輪調和日誌保留天數等功能。

Loguru 的基本範例

<code class="language-python">from loguru import logger

# 配置日志
logger.add("app.log", rotation="500 MB")  # 文件大小超过 500 MB 时自动轮转

# 记录日志消息
logger.info("这是一个信息消息。")
logger.warning("这是一个警告消息。")
logger.error("这是一个错误消息。")</code>

登入後複製

在這個例子中，我們不需要額外配置多個處理器。只需呼叫 logger.add() 即可輕鬆完成檔案日誌配置。

同時輸出到檔案和控制台

Loguru 可以非常方便地實現同時向檔案和控制台輸出：

<code class="language-python">from loguru import logger
import sys

# 添加日志输出到文件和控制台
logger.add("app.log", rotation="500 MB", retention="10 days")  # 文件轮转和保留 10 天
logger.add(sys.stdout, level="INFO")  # 输出到控制台

# 记录日志消息
logger.info("这是一个信息消息。")
logger.warning("这是一个警告消息。")
logger.error("这是一个错误消息。")</code>

登入後複製

這裡，logger.add(sys.stdout, level="INFO") 可以在無需額外配置的情況下將日誌顯示在控制台上。

2. Python 內建 logging 函式庫的優缺點

優勢

標準函式庫的一部分: logging 是 Python 標準函式庫的一部分，因此無需額外安裝，並且跨平台。
高度可自訂: logging 提供強大的自訂功能，可靈活控制日誌格式、等級和目標（檔案、控制台、遠端伺服器等）。
強大的相容性: 許多第三方函式庫也使用 logging，從而實現各種日誌的無縫整合。

缺點

複雜的配置: logging 的基本使用相對簡單，但稍微複雜的配置就會變得冗長且不直觀，尤其是在需要同時輸出到多個目標（例如文件和控制台）時。
不支援鍊式調用: logging 不支援像 loguru 這樣的鍊式調用，需要逐層配置。

基本範例

logging 的一個簡單的日誌範例如下：

<code class="language-python">import logging

# 配置日志
logging.basicConfig(
    level=logging.INFO,
    format='%(asctime)s - %(levelname)s - %(message)s',
    filename='app.log',
    filemode='a'
)

# 记录日志消息
logging.info("这是一个信息消息。")
logging.warning("这是一个警告消息。")
logging.error("这是一个错误消息。")</code>

登入後複製

在這個範例中，日誌將被記錄到 app.log 檔案中，但不會顯示在控制台中。如果我們想同時在控制台和檔案中顯示日誌，則需要額外配置 StreamHandler。

同時輸出到文件和控制台的配置

為了同時將日誌輸出到控制台和文件，我們需要配置多個 Handler。代碼如下：

<code class="language-python">from loguru import logger

# 配置日志
logger.add("app.log", rotation="500 MB")  # 文件大小超过 500 MB 时自动轮转

# 记录日志消息
logger.info("这是一个信息消息。")
logger.warning("这是一个警告消息。")
logger.error("这是一个错误消息。")</code>

登入後複製

可以看出，為了實現一個相對簡單的功能，我們需要創建不同的 Handler 並逐個配置它們。

3. logging 和 loguru 的詳細比較

特性	logging	loguru
配置复杂度	高，需要设置 Handlers	低，只需要 logger.add()
文件轮转和保留	需要第三方模块支持	内置支持轮转和保留
同时输出到控制台和文件	需要设置多个 Handlers	使用 sys.stdout 轻松实现
链式调用	不支持	支持
易用性	适用于复杂的配置和集成	适用于快速开发和清晰的日志管理