Java文件读写核心是按场景选API：小文件用Files（需显式指定Charset），大文件用BufferedInputStream/OutputStream，文本处理须用InputStreamReader/OutputStreamWriter配Charset，异常要分级捕获。
Java 中完成文件读写，核心不是选 API，而是分清场景：小文件直接用 Files，大文件或需控制流必须用 InputStream/OutputStream，混用字符编码（如中文）不指定 Charset 必出乱码。
小文件读写优先用 Files 工具类
适合配置文件、日志片段、JSON 文本等几 MB 以内的内容。它封装了底层流，一行代码就能搞定，但会把整个文件加载进内存，别用它读 GB 级日志。
常见写法：
String content = "Hello 世界";
Files.write(Paths.get("output.txt"), content.getBytes(StandardCharsets.UTF_8));
读取时务必显式传 StandardCharsets.UTF_8，否则 Windows 上默认 GBK，Linux/macOS 默认 UTF-8，跨平台必崩：
立即学习“Java免费学习笔记（深入）”；
String text = Files.readString(Paths.get("input.txt"), StandardCharsets.UTF_8);
-
Files.readAllLines()返回List，每行自动去\r\n -
Files.write()默认覆盖，加StandardOpenOption.APPEND才追加 - 路径不存在会抛
NoSuchFileException，父目录不存在则抛IOException，得提前Files.createDirectories()
大文件或逐块处理必须用 BufferedInputStream/BufferedOutputStream
读 GB 日志、传输视频、解析 CSV 流时，不能全载入内存。FileInputStream 和 FileOutputStream 没缓冲区，单字节读写极慢，必须套一层 Buffered 类。
示例：复制大文件
try (var in = new BufferedInputStream(new FileInputStream("a.zip"));
var out = new BufferedOutputStream(new FileOutputStream("b.zip"))) {
byte[] buf = new byte[8192];
int len;
while ((len = in.read(buf)) != -1) {
out.write(buf, 0, len);
}
}
- 缓冲区大小设
8192是经验值，太小频繁系统调用，太大无意义 - 务必用 try-with-resources，否则流不关会导致句柄泄漏
-
FileInputStream读的是原始字节，不处理编码；要读文本还得包InputStreamReader
读写文本文件别直接用 FileReader/FileWriter
这两个类默认使用平台编码，且不支持指定 Charset，是历史遗留坑。Java 11 后已标记为“legacy”，文档明确建议用 InputStreamReader + FileInputStream 替代。
正确做法：
try (var reader = new BufferedReader(
new InputStreamReader(
new FileInputStream("data.txt"), StandardCharsets.UTF_8))) {
String line;
while ((line = reader.readLine()) != null) {
System.out.println(line);
}
}
-
BufferedReader.readLine()自动处理\n、\r\n、\r -
FileWriter的append构造参数仅控制是否追加，跟编码无关 - 写文本推荐
Files.write()或BufferedWriter+OutputStreamWriter
异常处理不能只 catch IOException
Files 方法抛 IOException，但底层可能触发 SecurityException（沙箱环境）、AccessDeniedException（权限不足）、AtomicMoveNotSupportedException（跨文件系统移动失败）。生产代码里至少得区分 AccessDeniedException 和其他 IO 错误。
典型模式：
try {
Files.copy(src, dst, StandardCopyOption.REPLACE_EXISTING);
} catch (AccessDeniedException e) {
logger.error("无权访问: {}", e.getFile(), e);
} catch (IOException e) {
logger.error("IO 失败: {}", dst, e);
}
-
Files抛的异常是具体子类，可直接 instanceof 判断 - Windows 下对正在被记事本打开的文件执行
Files.delete()会抛AccessDeniedException，不是IOException - 不要用
throws Exception一揽子抛出，调用方无法针对性处理
真正难的从来不是“怎么写”，而是判断该用哪条路：文件大小、是否需要中断/跳转、编码是否可控、异常是否要分级响应——这些决策点比语法细节重要得多。
