文件 IO 入门

这一课你将能做到

1. 用 JDK 11+ 的 Files.readString/writeString 完成文本读写，用 BufferedReader 逐行处理大文件
2. 理解字节流与字符流的区别，知道什么时候用哪一个、编码为什么必须显式指定 UTF-8
3. 用 try-with-resources 安全操作文件——把上一课的异常知识落到资源管理实战

为什么要学

后端离不开文件 IO：本站场景里，日志落盘、配置文件读取（application.yml）、用户上传头像存储、Excel 导入导出、生成导出报表——底层全是文件操作。

Java 的 IO 类库历史悠久（1996 年的 java.io、2002 年的 NIO、2007 年的 NIO.2），新手最容易被 File、FileInputStream、Reader、Path、Files 十几个类绕晕。本课直接采用现代写法：JDK 7+ 的 Path/Files + JDK 11+ 的便捷读写方法，覆盖日常 90% 场景，老 API 只需认识（以后读别人代码会碰到）。

先建立图像

数据的外壳          数据的内容
Path（路径）  ──▶  Files（操作）  ──▶  内容
"demo.txt"        readString /        "你好\nJava"
                   writeString /
                   copy / walk

字节流 vs 字符流：
  字节流 InputStream/OutputStream  → 处理二进制（图片、zip、视频），按 8 位字节
  字符流 Reader/Writer             → 处理文本，按「字符」读，自动解码
                                     字符流必须知道编码（UTF-8/GBK），否则中文乱码

跟着做

步骤 1：三行读写一个文件

新建 QuickIo.java：

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;

public class QuickIo {
    public static void main(String[] args) throws IOException {
        Path file = Path.of("demo.txt");          // Path.of 是 JDK 11+ 的写法

        // 写入：整个字符串一次写完（默认 UTF-8；不存在则创建，存在则覆盖）
        Files.writeString(file, "你好, CodeRoadMap\n第二行: Spring Boot + MySQL + Redis");
        System.out.println("文件已生成: " + file.toAbsolutePath());

        // 读取：整个文件一次读进内存
        String content = Files.readString(file);
        System.out.println("---- 文件内容 ----");
        System.out.println(content);
    }
}

适用边界：readString 一次载入全量内容，适合配置、小文件（几 MB 内）。几百 MB 的日志用它会把堆撑爆——逐行读见步骤 3。

步骤 2：常用 Files 操作集

import java.io.IOException;
import java.nio.file.*;

public class FilesOps {
    public static void main(String[] args) throws IOException {
        Path dir = Path.of("data");
        Path src = dir.resolve("a.txt");        // resolve：拼子路径（跨平台分隔符）
        Path dst = Path.of("data", "b.txt");    // 多段拼接

        Files.createDirectories(dir);           // 建多级目录（已存在不报错）
        Files.writeString(src, "hello io");

        System.out.println(Files.exists(src));  // true
        System.out.println(Files.isRegularFile(src)); // true
        System.out.println(Files.size(src));    // 8（字节数）

        // 复制 / 移动 / 删除
        Files.copy(src, dst, StandardCopyOption.REPLACE_EXISTING);
        Files.move(src, Path.of("data", "renamed.txt"),
                StandardCopyOption.REPLACE_EXISTING);
        Files.deleteIfExists(dst);              // 存在才删，避免 NoSuchFileException

        // 遍历目录（一层）
        try (var entries = Files.list(dir)) {
            entries.forEach(e -> System.out.println("条目: " + e.getFileName()));
        }
        // 深度递归遍历用 Files.walk(dir)
    }
}