Linux Java日志输出配置指南

在Linux环境下配置Java应用程序的日志输出，其实走通就那么几步。下面把整个过程拆开来讲，从框架选择到实际跑起来，每一步都有落实点。 

1. 选个趁手的日志框架

Java世界里日志框架不少，主流的三驾马车：Log4j、Logback和SLF4J。SLF4J更像是一个门面（Facade），真正干活的底层实现可以选Log4j 2或Logback。如果你还在用Log4j 1.x，建议尽快迁移到2.x，性能和安全性都提升了一大截。选框架的核心原则：跟项目现有生态匹配，别给自己挖坑。

2. 加依赖，版本别搞错

用Maven的话，在pom.xml里把依赖贴进去。注意版本号要对齐，尤其是Log4j 2和SLF4J的桥接包，版本不一致容易在运行时抛ClassNotFoundException。

    org.apache.logging.log4j
    log4j-core
    2.17.1



    org.slf4j
    slf4j-api
    1.7.36



    org.apache.logging.log4j
    log4j-slf4j-impl
    2.17.1

如果用的是Gradle，语法稍有不同，但依赖坐标是一样的。

3. 写配置文件，决定日志去哪

日志框架靠配置文件干活。这里给出一个Log4j 2的典型配置log4j2.xml，放在src/main/resources目录下自动加载：

这里定义了两个Appender：一个输出到控制台（方便开发调试），一个输出到logs/app.log文件（生产环境保留日志）。日志格式里包含了时间戳、日志级别、类名、行号和消息，这个格式很实用，定位问题一目了然。你也可以根据自己的需要调整level，比如把info改成debug来输出更详细的信息。

4. 在代码里打日志，只需几行

用SLF4J的API，在类里声明一个Logger实例，然后像下面这样调用：

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

public class MyApp {
    private static final Logger logger = LoggerFactory.getLogger(MyApp.class);
    
    public static void main(String[] args) {
        logger.info("Application started");
        // Your application code here
        logger.info("Application finished");
    }
}

注意：Logger要声明为private static final，这是标准做法，避免每个实例都创建一遍。另外，不要在关键路径上用logger.isDebugEnabled()手动检查——现在的日志框架内部已经做了性能优化，除非你真的在极度高并发场景下写大量日志，否则不必多此一举。

5. 编译与运行，注意类路径分隔符

假设所有jar包和源码都在同一目录下，先编译再运行：

javac -cp .:log4j-core-2.17.1.jar:slf4j-api-1.7.36.jar:log4j-slf4j-impl-2.17.1.jar MyApp.java
java -cp .:log4j-core-2.17.1.jar:slf4j-api-1.7.36.jar:log4j-slf4j-impl-2.17.1.jar MyApp

坑点提醒：Linux下类路径分隔符是冒号（:），Windows下是分号（;）。如果你在Linux上用Maven或Gradle打包成可执行JAR，这一步反而更简单——直接用java -jar即可，不需要手动指定classpath。但如果你还在手动编译，千万注意分隔符差异，否则ClassNotFoundException会让人抓狂。 六步走完，日志就能正常输出了。实际项目中你可能还需要考虑日志滚动（按天或按大小切割）、异步写入、远程收集等等，但上面的基础配置足够应付大部分场景。先跑起来，再根据需要调优。