Java IO 流与文件操作实战指南

创建与删除

import java.io.File;
import java.io.IOException;

public class Main {
    public static void main(String[] args) throws IOException {
        File file = new File("test.txt");
        if (!file.exists()) {
            boolean created = file.createNewFile();
            System.out.println("创建成功：" + created);
        }
        // 谨慎操作，delete() 不经过回收站
        file.delete(); 
    }
}

目录创建区别

新手常混淆 mkdir() 和 mkdirs()：

• mkdir()：仅创建单层目录，父目录不存在则失败。
• mkdirs()：递归创建所有缺失的父目录。

File dir = new File("parent\\child");
dir.mkdirs(); // 推荐方式

三、IO 流：文件内容读写

文件操作分为'读'和'写'，对应输入流（InputStream）和输出流（OutputStream）。

1. 字节流：通用性强

字节流以字节为单位，适合所有文件类型（文本、图片等）。

读取文件

FileInputStream 是常用子类。核心方法是 read()。

• read()：读 1 个字节。
• read(byte[] b)：读数组，效率高。

最佳实践：使用 try-with-resources 自动关闭流，避免资源泄漏。

import java.io.FileInputStream;
import java.io.InputStream;

public class ReadDemo {
    public static void main(String[] args) throws Exception {
        try (InputStream is = new FileInputStream("hello.txt")) {
            byte[] buf = new byte[1024];
            int len;
            while ((len = is.read(buf)) != -1) {
                for (int i = 0; i < len; i++) {
                    System.out.print((char) buf[i]);
                }
            }
        }
    }
}

写入文件

FileOutputStream 用于写入。注意数据会先进入缓冲区，需调用 flush() 刷新到磁盘。

import java.io.FileOutputStream;
import java.io.OutputStream;

public class WriteDemo {
    public static void main(String[] args) throws Exception {
        try (OutputStream os = new FileOutputStream("output.txt")) {
            String s = "你好中国";
            byte[] b = s.getBytes("UTF-8");
            os.write(b);
            os.flush(); // 必须刷新
        }
    }
}

2. 字符流：文本更友好

处理文本时，字符流能自动处理编码问题，避免中文乱码。

读取文本

使用 Scanner 配合 InputStream，指定 UTF-8 编码。

import java.util.Scanner;
import java.io.FileInputStream;
import java.io.InputStream;

public class ScannerRead {
    public static void main(String[] args) throws Exception {
        try (InputStream is = new FileInputStream("hello.txt")) {
            try (Scanner sc = new Scanner(is, "UTF-8")) {
                while (sc.hasNextLine()) {
                    System.out.println(sc.nextLine());
                }
            }
        }
    }
}

写入文本

PrintWriter 提供类似 print()、println() 的方法，支持格式化输出。

import java.io.PrintWriter;
import java.io.OutputStreamWriter;
import java.io.FileOutputStream;

public class PrintWriterWrite {
    public static void main(String[] args) throws Exception {
        try (OutputStream os = new FileOutputStream("out.txt")) {
            try (OutputStreamWriter writer = new OutputStreamWriter(os, "UTF-8")) {
                try (PrintWriter pw = new PrintWriter(writer)) {
                    pw.println("第一行");
                    pw.printf("%d: 第三行\n", 3);
                    pw.flush();
                }
            }
        }
    }
}

四、实战案例

案例 1：扫描并删除指定文件

需求：遍历目录，查找含关键词的文件并删除。

import java.io.File;
import java.util.ArrayList;
import java.util.List;
import java.util.Scanner;

public class DeleteFiles {
    public static void main(String[] args) {
        Scanner scanner = new Scanner(System.in);
        System.out.print("请输入根目录：");
        String rootPath = scanner.next();
        File rootDir = new File(rootPath);
        
        if (!rootDir.isDirectory()) return;
        
        System.out.print("请输入关键词：");
        String token = scanner.next();
        List<File> result = new ArrayList<>();
        scanDir(rootDir, token, result);
        
        for (File f : result) {
            System.out.print(f.getPath() + " 是否删除？(y/n): ");
            if (scanner.next().equalsIgnoreCase("y")) {
                f.delete();
            }
        }
    }

    private static void scanDir(File dir, String token, List<File> list) {
        File[] files = dir.listFiles();
        if (files == null) return;
        for (File f : files) {
            if (f.isDirectory()) {
                scanDir(f, token, list); // 递归
            } else if (f.getName().contains(token)) {
                list.add(f);
            }
        }
    }
}

案例 2：文件复制工具

支持任意文件类型的复制，利用字节流缓冲提高效率。

import java.io.*;

public class CopyFile {
    public static void main(String[] args) throws Exception {
        String src = "source.txt";
        String dest = "dest.txt";
        
        try (InputStream is = new FileInputStream(src);
             OutputStream os = new FileOutputStream(dest)) {
            byte[] buf = new byte[1024];
            int len;
            while ((len = is.read(buf)) != -1) {
                os.write(buf, 0, len);
            }
            os.flush();
        }
        System.out.println("复制完成");
    }
}

案例 3：搜索文件内容

在案例 1 基础上增加内容匹配逻辑。

// 核心逻辑片段
private static boolean isContentContains(File file, String token) throws IOException {
    StringBuilder sb = new StringBuilder();
    try (InputStream is = new FileInputStream(file);
         Scanner sc = new Scanner(is, "UTF-8")) {
        while (sc.hasNextLine()) {
            sb.append(sc.nextLine()).append("\n");
        }
    }
    return sb.indexOf(token) != -1;
}

五、避坑总结

1. File 对象非实体：创建 File 对象不等于创建文件，需调用 createNewFile()。
2. 目录创建：多层目录务必用 mkdirs()。
3. 资源管理：优先使用 try-with-resources 自动关闭流。
4. 缓冲区刷新：OutputStream 写入后记得 flush()。
5. 编码设置：处理中文时显式指定 UTF-8，防止乱码。

掌握这些核心点，你就能从容应对大多数文件操作场景。多动手跑通代码，比死记硬背更有效。