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，并实现灵活高效的日志管理。