Python 日誌記錄：loguru 與日誌記錄

Python 日誌庫對比：logging vs loguru

1. Loguru 簡化日誌記錄

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

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

Loguru 的優勢

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

Loguru 的基本範例

from loguru import logger

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

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

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

同時輸出到檔案和控制台

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

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("这是一个错误消息。")

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

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

優勢

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

缺點

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

基本範例

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

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("这是一个错误消息。")

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

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

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

from loguru import logger

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

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

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

3. logging 和 loguru 的詳細比較

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

4. 建議的應用場景

• 簡單的應用程式和快速開發: Loguru 是更好的選擇。它簡潔直觀，適合快速原型設計和小型專案。
• 複雜的應用程式和多模組專案: logging 提供的高度可自訂功能更適合需要多層級配置的複雜系統，特別是那些依賴第三方程式庫並希望統一日誌管理的項目。

5. 總結

Loguru 和 logging 各有優缺點。對於大多數 Python 專案而言，Loguru 簡潔的語法和強大的功能使其成為快速開發的首選。對於大型項目，標準庫 logging 的兼容性和靈活性更適用。希望本文能幫助您為您的專案選擇合適的日誌工具。

Leapcell：最佳無伺服器 Web 代管平台

最後，我想推薦一個部署 Python 應用程式的最佳平台：Leapcell

1. 多語言支援

• 使用 JavaScript、Python、Go 或 Rust 進行開發。

2. 免費部署無限專案

• 只需為使用付費－無請求，無費用。

3. 無與倫比的成本效益

• 隨選付費，無空閒費用。
• 例如：25 美元支援 694 萬次要求，平均回應時間為 60 毫秒。

4. 簡化的開發者體驗

• 直覺的 UI，輕鬆設定。
• 全自動 CI/CD 管道和 GitOps 整合。
• 即時指標和日誌記錄，提供可操作的見解。

5. 輕鬆擴充與高效能

• 自動擴充以輕鬆處理高並發。
• 零營運開銷－只需專注於建置。

在文件中了解更多！

Leapcell Twitter：https://www.php.cn/link/7884effb9452a6d7a7a79499ef854afd

以上是Python 日誌記錄：loguru 與日誌記錄的詳細內容。更多資訊請關注PHP中文網其他相關文章！