Logback 是 Java 應用中廣泛使用的日志框架，以下是其核心使用方法及最佳實踐：

---

1. 引入依賴

在 Maven 或 Gradle 項目中添加 Logback 及 SLF4J 依賴：

<!-- Maven -->
<dependency><groupId>ch.qos.logback</groupId><artifactId>logback-classic</artifactId><version>1.4.10</version>
</dependency>
<dependency><groupId>org.slf4j</groupId><artifactId>slf4j-api</artifactId><version>1.7.36</version>
</dependency>

// Gradle
implementation 'ch.qos.logback:logback-classic:1.4.10'
implementation 'org.slf4j:slf4j-api:1.7.36'

注：logback-classic 包含核心模塊和 SLF4J 實現，需確保版本兼容性。

---

2. 配置文件

在 src/main/resources 下創建 logback.xml，定義日志輸出策略：

<configuration><!-- 控制臺輸出 --><appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender"><encoder><pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern></encoder></appender><!-- 文件滾動輸出 --><appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender"><file>logs/app.log</file><rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy"><fileNamePattern>logs/app.%d{yyyy-MM-dd}.log</fileNamePattern><maxHistory>30</maxHistory></rollingPolicy><encoder><pattern>%msg%n</pattern></encoder></appender><!-- 根日志配置 --><root level="INFO"><appender-ref ref="CONSOLE" /><appender-ref ref="FILE" /></root>
</configuration>

關鍵配置項：

• Appender：定義日志輸出目標（控制臺、文件等）。
• Pattern：日志格式，支持時間戳、線程名、日志級別等占位符。
• RollingPolicy：按時間或大小滾動日志文件，避免文件過大。

---

3. 代碼中使用

通過 SLF4J API 記錄日志：

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;public class Example {private static final Logger logger = LoggerFactory.getLogger(Example.class);public void doSomething() {logger.trace("Trace 級別日志");logger.debug("Debug 級別日志");logger.info("Info 級別日志");logger.warn("Warn 級別日志");logger.error("Error 級別日志");}
}

說明：

• 日志級別從低到高為 TRACE < DEBUG < INFO < WARN < ERROR，根日志級別設置為 INFO 時，僅輸出 INFO 及以上級別日志。
• 異常日志需傳遞 Throwable 對象：logger.error("錯誤信息", e)。

---

4. 高級功能

• 異步日志：通過 AsyncAppender 提升性能，減少主線程阻塞。
• MDC 上下文：添加請求ID等上下文信息：

  MDC.put("requestId", "12345");
  logger.info("帶上下文的日志");
  MDC.remove("requestId");
  

• 日志過濾：按包名或關鍵字過濾日志：

  <logger name="com.example.dao" level="DEBUG" />
  <logger name="com.example.util" level="WARN" />
  

---

5. 最佳實踐

1. 統一日志格式：生產環境中建議包含時間戳、線程名、類名等信息。
2. 按環境分級：開發環境用 DEBUG，生產環境用 INFO 或 WARN。
3. 日志文件管理：定期清理舊日志，避免磁盤占滿。
4. 避免過度日志：敏感信息（如密碼）需脫敏處理。

---

常見問題

• 日志不輸出：檢查依賴沖突、配置文件路徑是否正確。
• 性能問題：異步日志可減少 I/O 阻塞。
• 版本兼容性：確保 logback-classic 與 slf4j-api 版本匹配。

通過以上步驟，可快速在 Java 項目中集成 Logback，并實現靈活高效的日志管理。