JAVA重点基础、进阶知识及易错点总结（14）字节流 字符流

Java 巩固进阶 · 第14天主题字节流 字符流 —— 文件读写的核心引擎 进度概览今天进入 IO 流的灵魂章节掌握这 4 个核心类你就能打通文件读写的任督二脉。 核心价值万能字节流InputStream/OutputStream处理图片/视频/任意二进制文件文件上传下载的基石。文本字符流Reader/Writer专为纯文本设计自动处理编码彻底告别中文乱码。资源安全try-with-resources语法自动关闭流杜绝资源泄漏生产环境红线。性能基石理解缓冲思想为明天学习高效流打下理论基础。一、流的分类一张图看懂选型逻辑 ️┌─ 字节流 (Byte Stream) ──► InputStream / OutputStream │ ├─ 万能能读任何文件图片/音频/视频/文本 │ ├─ 单位字节 (byte)8 位 │ └─ 场景文件复制、图片上传、网络传输 │ Java IO 流 ─────┤ │ ┌─ 字符流 (Char Stream) ──► Reader / Writer │ ├─ 专用只能读纯文本.txt/.java/.md/.yml │ ├─ 单位字符 (char)16 位 (Unicode) │ ├─ 核心优势内置编码转换防中文乱码 │ └─ 场景配置文件读取、日志写入、模板渲染 │ └─ 选型口诀 一切文件皆字节文本优先用字符 不确定时用字节永远不亏保平安 本质区别编码编码编码对比项字节流字符流处理单位byte(8 位)char(16 位, Unicode)编码感知❌ 无感知原样读写✅ 自动编解码 (默认平台编码)中文处理可能乱码需手动转码自动处理不易乱码适用文件所有文件二进制 文本仅纯文本文件父类InputStream/OutputStreamReader/Writer⚠️中文乱码根源// 字节流读中文如果编码不匹配必乱码FileInputStreaminnewFileInputStream(cn.txt);// 文件是 UTF-8byte[]bufnewbyte[1024];in.read(buf);StringtextnewString(buf);// ❌ 默认用平台编码(如GBK)解码 UTF-8 字节 → 乱码// ✅ 正确显式指定编码StringtextnewString(buf,StandardCharsets.UTF_8);// 字符流自动用指定编码解码推荐FileReaderfrnewFileReader(cn.txt);// 默认平台编码仍可能乱码// ✅ 最佳用 InputStreamReader 包装字节流显式指定编码InputStreamReaderisrnewInputStreamReader(newFileInputStream(cn.txt),StandardCharsets.UTF_8);二、字节流实战FileInputStream / FileOutputStream1. 读取文件三种姿势推荐缓冲 数组// ❌ 姿势1单字节读取慢100 次 IO不推荐FileInputStreaminnewFileInputStream(a.txt);intb;while((bin.read())!-1){// 每次读 1 字节System.out.print((char)b);}in.close();// ✅ 姿势2字节数组 缓冲快推荐⭐FileInputStreaminnewFileInputStream(a.txt);byte[]bufnewbyte[1024*8];// 8KB 缓冲平衡内存与效率intlen;while((lenin.read(buf))!-1){// len 是实际读取字节数// ⚠️ 关键必须用 0, len避免读取上次残留数据System.out.print(newString(buf,0,len,StandardCharsets.UTF_8));}in.close();// ✅✅ 姿势3try-with-resources NIO现代写法明天学2. 写入文件覆盖写 vs 追加写// 构造方法第二个参数true追加false/省略覆盖FileOutputStreamoutnewFileOutputStream(log.txt,true);// ✅ 追加模式// 写入字节数组out.write(Hello IO\n.getBytes(StandardCharsets.UTF_8));// 写入部分字节配合读取时的 len 使用byte[]dataPartial.getBytes();out.write(data,0,data.length);out.close();// ⚠️ 必须 close() 或 flush()否则数据可能滞留缓冲区3. 文件复制万能模板背下来/** * 通用文件复制方法支持任意文件图片/视频/文本 */publicstaticvoidcopyFile(Filesrc,Filedest)throwsIOException{// 1. 确保目标父目录存在Fileparentdest.getParentFile();if(parent!null!parent.exists()){parent.mkdirs();}// 2. try-with-resources 自动关流重点try(FileInputStreaminnewFileInputStream(src);FileOutputStreamoutnewFileOutputStream(dest)){byte[]bufnewbyte[1024*16];// 16KB 缓冲性能与内存平衡intlen;while((lenin.read(buf))!-1){out.write(buf,0,len);// ⚠️ 关键只写实际读取的字节}// ✅ 无需手动 flush()/close()try-with-resources 自动处理}}为什么out.write(buf, 0, len)而不是out.write(buf)假设 buf 大小1024最后一次读取只读了 100 字节 - buf[0~99] 是新数据buf[100~1023] 是上次残留的旧数据 - 如果写整个 buf会多写 924 字节垃圾数据❌ - 正确只写 0~len-1 的有效数据 ✅三、字符流实战FileReader / FileWriter纯文本专用1. 读取文本自动解码但要注意默认编码陷阱// ⚠️ 陷阱FileReader 使用平台默认编码Windows 通常是 GBK// 如果文件是 UTF-8 编码中文可能乱码FileReaderfrnewFileReader(cn.txt);// 隐式用默认编码解码intch;while((chfr.read())!-1){System.out.print((char)ch);}fr.close();// ✅ 最佳实践用 InputStreamReader 包装字节流显式指定编码try(InputStreamReaderisrnewInputStreamReader(newFileInputStream(cn.txt),StandardCharsets.UTF_8)){char[]cbufnewchar[1024];intlen;while((lenisr.read(cbuf))!-1){System.out.print(newString(cbuf,0,len));}}2. 写入文本同样注意编码一致性// ⚠️ FileWriter 同样使用平台默认编码FileWriterfwnewFileWriter(out.txt,true);// 追加模式fw.write(你好世界\n);// 用平台编码编码字符fw.close();// ✅ 最佳OutputStreamWriter 显式编码try(OutputStreamWriteroswnewOutputStreamWriter(newFileOutputStream(out.txt,true),StandardCharsets.UTF_8)){osw.write(你好UTF-8 编码的世界\n);// osw.flush(); // 可手动刷新但 close() 会自动 flush} FileReader vs InputStreamReader 对比特性FileReaderInputStreamReader FileInputStream编码控制❌ 只能用平台默认编码✅ 可显式指定任意编码UTF-8/GBK 等跨平台❌ 可能因系统编码不同导致乱码✅ 编码固定行为一致推荐度⭐⭐仅测试/内部工具⭐⭐⭐⭐⭐生产环境首选SpringBoot 实践读取application.yml或模板文件时永远显式指定编码Value(classpath:templates/email.html)privateResourcetemplate;privateStringreadTemplate()throwsIOException{try(InputStreamistemplate.getInputStream();InputStreamReaderreadernewInputStreamReader(is,StandardCharsets.UTF_8)){returnStreamUtils.copyToString(reader);// Spring 工具类}}四、资源管理try-with-resources生产环境红线⚠️1. 为什么必须用// ❌ 传统写法异常时可能漏关流 → 资源泄漏 → 线上事故FileInputStreaminnull;try{innewFileInputStream(a.txt);// ... 业务逻辑if(error)return;// ⚠️ 提前返回close() 没执行}catch(IOExceptione){e.printStackTrace();}finally{if(in!null){try{in.close();}catch(IOExceptione){e.printStackTrace();}// 嵌套 try-catch代码臃肿}}// ✅ 现代写法自动关流代码简洁异常安全try(FileInputStreaminnewFileInputStream(a.txt)){// ... 业务逻辑// 无论正常返回还是抛出异常in.close() 都会自动调用}catch(IOExceptione){e.printStackTrace();// 只需处理业务异常}2. 使用条件 原理条件资源类必须实现java.lang.AutoCloseable接口所有 IO 流都实现了 ✅原理编译器自动生成finally块按声明逆序关闭资源多资源用分号;分隔关闭顺序后声明的先关闭// 多资源示例文件复制try(FileInputStreaminnewFileInputStream(src.txt);FileOutputStreamoutnewFileOutputStream(dest.txt)){// 先关 out再关 inbyte[]bufnewbyte[8192];intlen;while((lenin.read(buf))!-1){out.write(buf,0,len);}// ✅ 无需手动 flush/close}catch(IOExceptione){log.error(文件复制失败,e);// 生产环境用日志框架}关闭顺序为什么重要装饰者模式流如BufferedInputStream包装FileInputStream关闭外层流时会自动关闭内层流按逆序关闭确保缓冲数据先刷新到底层流五、 今日实战任务构建简易文件工具类任务1实现通用文件读取方法支持编码/** * 读取文件内容为字符串 * param file 文件 * param charset 字符编码如 UTF_8 * return 文件内容 */publicstaticStringreadFileToString(Filefile,Charsetcharset)throwsIOException{// TODO: 用 try-with-resources InputStreamReader 实现// 要求处理文件不存在、编码异常等边界情况}// 测试分别用 UTF-8 和 GBK 读取含中文的文件观察结果任务2实现安全文件复制带进度回调/** * 复制大文件时提供进度回调SpringBoot 上传常用 * param src 源文件 * param dest 目标文件 * param callback 进度回调 (current, total) - void */publicstaticvoidcopyFileWithProgress(Filesrc,Filedest,ProgressCallbackcallback)throwsIOException{// TODO:// 1. 用 16KB~64KB 缓冲数组// 2. 每复制一定字节如 10%调用 callback.progress(current, total)// 3. 处理目标文件已存在的场景覆盖/跳过/重命名}// 回调接口定义FunctionalInterfacepublicinterfaceProgressCallback{voidprogress(longcopied,longtotal);}任务3字符编码转换工具/** * 将文件从一种编码转换为另一种编码如 GBK → UTF-8 * param srcFile 源文件originalCharset 编码 * param destFile 目标文件targetCharset 编码 */publicstaticvoidconvertEncoding(FilesrcFile,FiledestFile,CharsetoriginalCharset,CharsettargetCharset)throwsIOException{// TODO: 用 InputStreamReader OutputStreamWriter 实现编解码转换// 挑战处理 BOM 头Byte Order Mark}任务4SpringBoot 集成小练习# application.ymlapp:file:upload-dir:./uploadsdefault-charset:UTF-8ServicepublicclassFileService{Value(${app.file.default-charset})privateStringdefaultCharset;/** * 上传文件保存并返回访问路径 * 要求 * 1. 校验文件扩展名白名单机制 * 2. 重命名文件UUID 原扩展名防覆盖 * 3. 用字节流复制上传内容 * 4. 记录文件元数据大小、编码、上传时间 */publicFileInfoupload(MultipartFilefile)throwsIOException{// TODO: 实现上传逻辑// 提示MultipartFile.getInputStream() 返回字节流}} 第14天 · 核心总结极简背诵版选型决策树要读/写的文件是 ├─ 图片/音频/视频/任意二进制 → 字节流 (InputStream/OutputStream) ├─ 纯文本 (.txt/.java/.yml) → 字符流 (Reader/Writer) └─ 不确定 → 用字节流 显式编码转换永远安全编码防坑指南字节流转字符串new String(bytes, Charset)必须指定编码字符流底层FileReader用平台默认编码生产环境建议用InputStreamReader 显式编码统一项目编码-Dfile.encodingUTF-8 编辑器保存为 UTF-8资源管理铁律✅ 永远用try-with-resources自动关流✅ 多资源用分号分隔关闭顺序后声明先关闭❌ 禁止手动close()放在try块末尾异常时可能不执行高性能复制模板背下来try(InputStreaminnewFileInputStream(src);OutputStreamoutnewFileOutputStream(dest)){byte[]bufnewbyte[16*1024];// 16KB 缓冲intlen;while((lenin.read(buf))!-1){out.write(buf,0,len);// ⚠️ 关键只写有效字节}}SpringBoot 实践点文件上传MultipartFile.getInputStream() 字节流复制配置读取Value ResourceInputStreamReader(UTF-8)日志写入FileWriter追加模式 自动轮转结合 Logback