作为 Java 开发者，你是否还在为 Spring Boot 项目中的日志打印而头疼？每次都要写 private static final Logger log = LoggerFactory.getLogger(XXX.class);，不仅繁琐，还容易出错。一行注解，解放双手，告别模板代码！ 今天我们就用 @Slf4j 让日志打印变得优雅简单。

痛点直击：传统日志的三大罪

1. 重复劳动：每个类都要手动声明 Logger 对象
2. 易错：复制粘贴时容易忘记修改类名
3. 冗余：无关代码挤占业务逻辑空间

传统写法示例：

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class OrderService {
    // 每个类都要写这行！
    private static final Logger log = LoggerFactory.getLogger(OrderService.class);
    
    public void createOrder(Order order) {
        if (order == null) {
            log.warn("创建订单失败：订单对象为空"); // 打印日志
        }
        // 业务逻辑...
    }
}

神兵利器：@Slf4j 注解

Lombok 的 @Slf4j 注解自动帮你生成 log 对象，无需手动声明！

三步实现极简日志

1. 添加依赖（Maven 示例）：

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.30</version> <!-- 使用最新版本 -->
    <scope>provided</scope>
</dependency>

2. 类上添加注解：

import lombok.extern.slf4j.Slf4j;

@Slf4j // 关键注解！
@Service
public class PaymentService {
    // 无需声明 Logger！
}

3. 直接使用 log 对象：

public boolean processPayment(PaymentRequest request) {
    log.debug("开始处理支付请求：{}", request.getOrderId()); // 自动注入log
    
    try {
        // 支付逻辑...
        log.info("支付成功，订单：{}", request.getOrderId());
        return true;
    } catch (Exception e) {
        log.error("支付处理异常！订单：{}", request.getOrderId(), e); // 自动记录异常栈
        return false;
    }
}

实战技巧：日志高级用法

1. 动态占位符{}（性能更优）

// 传统拼接（不推荐！产生多余字符串）
log.debug("用户ID：" + userId + " 操作失败");

// 优雅写法（推荐！）
log.debug("用户ID：{} 操作失败", userId);

2. 异常堆栈打印

try {
    // 可能出错的代码
} catch (BusinessException ex) {
    log.error("业务异常【错误码：{}】- 请求参数：{}", 
        ex.getCode(), 
        JsonUtils.toJson(request),  // 打印参数
        ex); // 关键：传入异常对象自动打印堆栈
}

3. 条件日志输出

// 只在高日志级别下执行复杂逻辑
if (log.isDebugEnabled()) {
    log.debug("订单详情：{}", generateComplexReport(order)); // 避免不必要的性能消耗
}

为什么选择 SLF4J + Lombok？

实测数据：在 500 个类的项目中，使用 @Slf4j 可减少 3000+ 行重复代码！

常见问题 Q&A

Q：IntelliJ IDEA 不识别 log 对象？
A：安装 Lombok 插件（Settings → Plugins → 搜索 Lombok）

Q：如何切换日志级别？
A：在 application.yml 中配置：

logging:
  level:
    root: info
    com.example.service: debug # 包路径精准控制

Q：生产环境怎么避免打印敏感数据？
A：使用日志脱敏工具：

log.info("用户手机号：{}", maskPhone(user.getPhone()));

// 脱敏工具方法
private String maskPhone(String phone) {
    return phone.replaceAll("(\\d{3})\\d{4}(\\d{4})", "$1****$2");
}

结语

@Slf4j + Lombok 的组合，将日志代码精简率提升 90% 以上！ 再也不用在业务类里重复声明 Logger，让日志工具彻底回归辅助角色。现在就在项目中引入 Lombok，体验一行注解带来的极致效率吧！

记住：优秀的开发者，绝不会把时间浪费在重复劳动上！