背景介绍：

在软件开发过程中，日志是非常重要的组成部分。它可以记录系统运行时的信息，帮助我们排查问题和优化代码。在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>

在上述依赖中，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.");
    }
}

上面的代码演示了如何使用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>

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

总结：

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