背景介绍：

在软件开发过程中，日志是非常重要的组成部分。它可以记录系统运行时的信息，帮助我们排查问题和优化代码。在 Java 开发中，常用的日志库有 commons-logging 和 slf4j。slf4j 是一个通用的日志门面，它提供了统一的日志接口，使得我们能够在代码中轻松切换不同的日志实现。而 commons-logging 是一个旧的日志库，它的使用方式相对复杂，不够灵活。本文将介绍如何从 commons-logging 迁移到 slf4j，以便提高代码的可维护性和可扩展性。

1. 导入 slf4j 依赖：

首先，我们需要在项目的构建文件中导入 slf4j 的依赖。对于 Maven 项目，可以在 pom.xml 文件中添加如下依赖：

<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-api</artifactId>
    <version>1.7.32</version>
</dependency>
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>jcl-over-slf4j</artifactId>
    <version>1.7.32</version>
    <scope>runtime</scope>
</dependency>
XML

在上述依赖中，slf4j-api 是 slf4j 的核心接口，jcl-over-slf4j 是将 commons-logging 转发到 slf4j 的适配器。使用 maven 命令或 IDE 工具同步依赖后，就可以在代码中使用 slf4j 了。

2. 替换日志接口：

接下来，我们需要将代码中的 commons-logging 替换成 slf4j 的日志接口。在代码中搜索并替换所有的 import 和代码中使用的 org.apache.commons.logging.Logger 为 org.slf4j.Logger，如下所示：

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

public class MyClass {
    private static final Logger logger = LoggerFactory.getLogger(MyClass.class);

    public void myMethod() {
        logger.info("This is a log message.");
    }
}
Java

上面的代码演示了如何使用 slf4j 的 Logger 进行日志记录。使用了 LoggerFactory 的 getLogger 方法获取 Logger 实例，参数指定为当前类的类名，这样可以准确地显示日志来源。然后，就可以使用 logger 对象的 info 等方法记录日志了。

3. 配置日志实现：

接下来，我们需要选择并配置 slf4j 的具体日志实现。常用的日志实现有 logback、log4j2 等。以 logback 为例，需要在项目中添加 logback.xml 或 logback-spring.xml 配置文件。配置文件中可以设置日志输出格式、级别、使用的 appender 等等。配置文件的具体内容根据需求来定，可以参考相关的 logback 文档和示例。

<configuration>
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>
 
    <root level="debug">
        <appender-ref ref="STDOUT"/>
    </root>
</configuration>
XML

在上述配置文件中，设置了一个输出到控制台的 appender，并指定了日志的输出格式为时间、线程信息、级别、类名、日志消息。然后，将该 appender 引用到根 logger，表示所有的日志输出都会使用该 appender。

总结：

本文介绍了如何从 commons-logging 迁移到 slf4j 的过程，包括导入依赖、替换日志接口和配置日志实现。通过使用 slf4j，我们能够更灵活地选择和切换不同的日志实现，而无需修改大量的代码。同时，slf4j 还提供了更加简洁和直观的日志接口，使得日志的书写和维护更加方便。因此，建议在新的 Java 项目中使用 slf4j 作为日志框架。