推荐优先使用Log4j2或SLF4J+Logback等成熟日志框架;若需自定义文件写入,可用FileWriter+BufferedWriter(追加模式+flush)或Files.write(APPEND+UTF-8),多线程下须同步或用BlockingQueue,生产环境务必考虑滚动、编码与路径健壮性。

Java中实现日志记录功能,推荐优先使用成熟日志框架(如Log4j2、SLF4J+Logback),而非手动用FileWriter写文件——既安全又灵活。若确需自定义文件写入日志(例如教学演示、轻量嵌入式场景),可基于Java NIO或传统IO封装简易日志工具,但务必注意线程安全、异常处理与性能问题。
用FileWriter+BufferedWriter写入日志文件
适合单线程、低频写入的简单场景。核心是追加模式打开文件,并及时刷新缓冲区:
- 创建FileWriter时传入true开启append模式:new FileWriter("app.log", true)
- 套一层BufferedWriter提升效率,每次log后调用writer.flush()确保内容落盘
- 用try-with-resources自动关闭流,避免资源泄漏
- 示例代码片段:
try (BufferedWriter writer = new BufferedWriter(new FileWriter("app.log", true))) {
writer.write("[" + new Date() + "] INFO: 用户登录成功\n");
writer.flush();
}
用Files.write()实现简洁日志写入(Java 7+)
适用于短日志、不频繁写入,语法更简洁,底层自动处理编码和关闭:
- 使用StandardOpenOption.APPEND保证追加写入
- 指定字符集(如UTF_8),避免中文乱码
- 一行日志即一次调用,适合调试或脚本化日志
- 示例:
String logLine = "[" + LocalDateTime.now() + "] DEBUG: 处理请求ID=1001";
Files.write(Paths.get("app.log"), (logLine + "\n").getBytes(StandardCharsets.UTF_8),
StandardOpenOption.CREATE, StandardOpenOption.APPEND);
多线程环境下必须加同步或使用线程安全方案
多个线程同时写同一文件极易导致内容错乱或覆盖:
立即学习“Java免费学习笔记(深入)”;
- 最简方式:用synchronized块包裹写入逻辑(影响吞吐量,仅限低并发)
- 更优选择:用java.util.concurrent.BlockingQueue做日志缓冲,单个守护线程消费并落盘(生产者-消费者模型)
- 终极建议:直接集成Log4j2,它内置异步Appender(AsyncLogger)和无锁队列,性能高且线程安全
补充关键细节:滚动、编码与路径管理
真实项目中,仅“写进去”远远不够:
- 文件滚动:手动实现需判断文件大小/日期,重命名旧文件(如app.log → app.log.2024-06-15),再新建;Log4j2的RollingFileAppender可自动完成
- 字符编码:显式指定UTF-8(尤其含中文日志),避免默认平台编码引发乱码
- 路径健壮性:用Paths.get("logs/app.log")而非硬编码绝对路径;写入前检查父目录是否存在,用Files.createDirectories()创建










