0

0

详解Java中的PrintWriter与PrintStream_格式化输出文本与日志记录

P粉602998670

P粉602998670

发布时间:2026-02-24 16:46:02

|

781人浏览过

|

来源于php中文网

原创

该选printwriter还是printstream取决于数据类型和场景:纯文本/日志用printwriter(支持指定编码、自动flush、异常不中断线程);二进制混合内容或兼容system.out时用printstream(需显式指定编码,注意平台默认编码陷阱),二者均非线程安全,多线程需加锁或改用专业日志框架。

详解java中的printwriter与printstream_格式化输出文本与日志记录

PrintWriter 和 PrintStream 什么时候该选哪个?

PrintWriter 是字符流,PrintStream 是字节流——这是最根本的分水岭。你写的是纯文本、日志、配置内容,用 PrintWriter;你要输出二进制混合内容(比如 HTTP 响应头 + 图片数据),或者必须兼容老代码里硬写的 System.out(它本身就是 PrintStream 实例),那就得用 PrintStream

  • PrintWriter 支持指定字符编码(如 new PrintWriter(file, "UTF-8")),PrintStream 构造时只能传 FileOutputStream,编码靠底层 OutputStreamWriter 隐式处理,容易踩默认平台编码坑
  • PrintWriterprintf()format() 方法抛出的是未检查异常(RuntimeException),PrintStream 同名方法也是,但它的 write() 系列方法可能触发 IOException,而 PrintWriter 默认吞掉异常(除非你显式调用 checkError()
  • 日志记录场景下,PrintWriter 更安全:能控制编码、不意外中断线程(因异常被吞)、支持自动 flush(autoFlush = true

PrintWriter.printf() 不生效?检查这三件事

printf() 看似调用了,文件却空着或内容不全——不是语法错,是流没刷出去。

  • 没开自动 flush:new PrintWriter(out, true) 第二个参数必须为 true,否则换行符不会触发刷盘;只靠 println() 不够,printf() 不带换行
  • 输出目标是文件但没 close:flush() 不等于 close(),尤其用 try-with-resources 时,别漏掉 close() 触发的最终 flush
  • 编码不匹配导致乱码掩盖内容:比如用 GBK 打开 UTF-8 写入的文件,看着像“没输出”,其实是字节解码失败

示例:

try (PrintWriter pw = new PrintWriter("log.txt", "UTF-8")) {
    pw.printf("User %s logged in at %tF%n", username, System.currentTimeMillis());
    // 这里没 println(),也没 flush(),且 autoFlush=false → 内容卡在缓冲区
}

PrintStream.println() 为什么有时中文变问号?

根本原因是 PrintStream 底层用的是平台默认编码(Windows 是 GBK,Linux/macOS 通常是 UTF-8),而你写入的字符串是 UTF-16(Java 字符串内部格式),转换时若没显式指定,就按系统猜。

Paraflow
Paraflow

AI产品设计智能体

下载

立即学习Java免费学习笔记(深入)”;

  • 直接传 File 构造:new PrintStream("a.txt") → 完全依赖系统编码,跨平台必出问题
  • 正确做法是包装 FileOutputStream + OutputStreamWriter,但那就绕过 PrintStream 了;更实际的解法是改用 PrintWriter,它构造函数明确支持编码字符串
  • 如果非用 PrintStream(比如要重定向 System.out),必须用 new PrintStream(new FileOutputStream(f), true, "UTF-8"),第三个参数才是编码名

日志记录别直接用 PrintWriter/PrintStream 做并发写入

它们都不是线程安全的写操作类。多个线程同时调 println(),可能一行日志被截断、两行粘连、甚至抛 NullPointerException(因内部 lock 字段未初始化)。

  • 单线程写文件没问题;多线程必须加锁,或用 java.util.logging.Loggerslf4j + logback 这类专为并发设计的日志框架
  • 即使加了 synchronized,PrintWritercheckError() 也不反映其他线程的错误状态,错误检测失效
  • 小项目图快用 PrintWriter 记日志可以,但只要涉及定时任务、Web 请求、异步回调,就得切到真正线程安全的日志方案

字符编码、自动刷盘、线程安全——这三个点漏掉任何一个,都会让看似简单的输出变成深夜排查现场。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
数据类型有哪几种
数据类型有哪几种

数据类型有整型、浮点型、字符型、字符串型、布尔型、数组、结构体和枚举等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

311

2023.10.31

php数据类型
php数据类型

本专题整合了php数据类型相关内容,阅读专题下面的文章了解更多详细内容。

223

2025.10.31

c语言 数据类型
c语言 数据类型

本专题整合了c语言数据类型相关内容,阅读专题下面的文章了解更多详细内容。

77

2026.02.12

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

866

2023.07.31

python中的format是什么意思
python中的format是什么意思

python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

452

2024.06.27

printf用法大全
printf用法大全

php中文网为大家提供printf用法大全,以及其他printf函数的相关文章、相关下载资源以及各种相关课程,供大家免费下载体验。

76

2023.06.20

fprintf和printf的区别
fprintf和printf的区别

fprintf和printf的区别在于输出的目标不同,printf输出到标准输出流,而fprintf输出到指定的文件流。根据需要选择合适的函数来进行输出操作。更多关于fprintf和printf的相关文章详情请看本专题下面的文章。php中文网欢迎大家前来学习。

300

2023.11.28

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

638

2023.08.03

Golang 生态工具与框架:扩展开发能力
Golang 生态工具与框架:扩展开发能力

《Golang 生态工具与框架》系统梳理 Go 语言在实际工程中的主流工具链与框架选型思路,涵盖 Web 框架、RPC 通信、依赖管理、测试工具、代码生成与项目结构设计等内容。通过真实项目场景解析不同工具的适用边界与组合方式,帮助开发者构建高效、可维护的 Go 工程体系,并提升团队协作与交付效率。

1

2026.02.24

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 3.9万人学习

C# 教程
C# 教程

共94课时 | 10.1万人学习

Java 教程
Java 教程

共578课时 | 71.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号