Java 实例 – 获取文件大小（完整指南）

Java 实例 – 获取文件大小：从入门到实战

在日常开发中，我们常常需要判断一个文件的大小，比如上传文件时限制大小、监控日志文件增长、批量处理数据前预估资源消耗。这些场景背后的核心需求，就是“获取文件大小”。今天我们就来深入探讨这个看似简单却非常实用的 Java 实例 – 获取文件大小。

想象一下，你正在开发一个文件管理工具，用户上传了一个 500MB 的视频文件。如果系统不提前检查文件大小，很可能导致内存溢出或上传失败。这时，获取文件大小就成为一道“安全门”，提前告诉你“这个文件有点大，得小心处理”。而 Java 提供了多种方式来实现这个功能，我们逐一来看。

使用 File 类的 length() 方法

这是最直接、最常用的获取文件大小的方法。Java 的 File 类提供了 length() 方法，它返回文件的大小（单位为字节）。这个方法简单高效，适合大多数基础场景。

import java.io.File;

public class FileSizeExample {
    public static void main(String[] args) {
        // 指定文件路径
        String filePath = "example.txt";

        // 创建 File 对象
        File file = new File(filePath);

        // 判断文件是否存在
        if (!file.exists()) {
            System.out.println("文件不存在：" + filePath);
            return;
        }

        // 调用 length() 方法获取文件大小（单位：字节）
        long fileSizeInBytes = file.length();

        // 输出结果
        System.out.println("文件大小：" + fileSizeInBytes + " 字节");
    }
}

代码注释说明：

• new File(filePath)：创建一个表示指定路径的 File 对象，但不会立即检查文件是否存在。
• file.exists()：在调用 length() 前先判断文件是否存在，避免抛出异常。
• file.length()：返回文件的大小，单位是字节（byte）。如果文件是目录，返回值为 0。
• long fileSizeInBytes：使用 long 类型是为了避免整数溢出，因为大文件的大小可能超过 int 的范围。

这个方法的优点是简洁、无需额外依赖。但要注意，它只能用于本地文件系统，不适用于网络资源或压缩包内的文件。

将字节转换为更易读的单位

直接输出“1024 字节”对用户来说不够友好。我们通常希望看到“1 KB”、“2.5 MB”这样的格式。下面是一个实用的工具方法，将字节转换为带单位的可读字符串。

public class FileSizeFormatter {
    public static String formatFileSize(long bytes) {
        // 定义单位数组
        String[] units = {"字节", "KB", "MB", "GB", "TB"};
        int unitIndex = 0;
        double size = bytes;

        // 逐级转换，直到单位不再大于 1024
        while (size >= 1024 && unitIndex < units.length - 1) {
            size /= 1024.0;
            unitIndex++;
        }

        // 保留两位小数，格式化输出
        return String.format("%.2f %s", size, units[unitIndex]);
    }

    public static void main(String[] args) {
        File file = new File("large_file.zip");
        if (file.exists()) {
            long sizeInBytes = file.length();
            String readableSize = formatFileSize(sizeInBytes);
            System.out.println("文件大小：" + readableSize);
            // 输出示例：文件大小：2.45 MB
        } else {
            System.out.println("文件不存在");
        }
    }
}

代码注释说明：

• units 数组定义了常见的文件大小单位。
• while (size >= 1024 && unitIndex < units.length - 1)：当当前大小大于等于 1024 时，继续转换到下一个单位。
• String.format("%.2f %s", size, units[unitIndex])：格式化输出，保留两位小数。
• 这种方式在用户界面展示时非常实用，比如文件管理器、上传进度条等。

使用 Files 类的 size() 方法（推荐）

Java 7 引入了 NIO.2（New I/O）包，其中 Files 工具类提供了更现代、更安全的文件操作方式。Files.size() 方法可以获取文件大小，它能自动处理异常，并且支持更多文件系统类型。

import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;

public class NioFileSizeExample {
    public static void main(String[] args) {
        // 定义文件路径
        String filePath = "data.log";

        // 将路径转换为 Path 对象
        Path path = Paths.get(filePath);

        try {
            // 调用 Files.size() 获取文件大小
            long fileSize = Files.size(path);
            System.out.println("文件大小：" + formatFileSize(fileSize));
        } catch (Exception e) {
            System.err.println("读取文件大小失败：" + e.getMessage());
        }
    }

    // 复用之前的格式化方法
    public static String formatFileSize(long bytes) {
        String[] units = {"字节", "KB", "MB", "GB", "TB"};
        int unitIndex = 0;
        double size = bytes;

        while (size >= 1024 && unitIndex < units.length - 1) {
            size /= 1024.0;
            unitIndex++;
        }

        return String.format("%.2f %s", size, units[unitIndex]);
    }
}

代码注释说明：

• Paths.get(filePath)：创建一个 Path 对象，NIO.2 推荐使用 Path 而不是 File。
• Files.size(path)：返回文件大小，单位是字节。如果文件不存在或无权限访问，会抛出 IOException。
• 使用 try-catch 包裹，避免程序因异常崩溃，体现健壮性。
• 这种方式更适合现代 Java 项目，尤其是 Spring Boot、微服务等场景。

处理大文件与性能考虑

当文件非常大（如 10GB 以上）时，length() 和 size() 方法仍然可以使用，但要注意以下几点：

1. 内存占用：这些方法只返回一个 long 值，不会加载文件内容，所以内存开销极小。
2. 性能：文件大小的获取通常非常快，因为操作系统内核会缓存元数据。
3. 权限问题：如果程序没有读取权限，调用会失败。建议在生产环境中添加权限检查逻辑。

// 示例：检查文件是否存在且可读
public static boolean canReadFile(String filePath) {
    Path path = Paths.get(filePath);
    return Files.exists(path) && Files.isReadable(path);
}

实际应用场景举例

场景一：文件上传校验

在 Web 后端开发中，上传文件前常需限制大小。例如：

public boolean isFileSizeValid(String filePath, long maxSizeInBytes) {
    Path path = Paths.get(filePath);
    if (!Files.exists(path)) {
        return false;
    }
    try {
        long actualSize = Files.size(path);
        return actualSize <= maxSizeInBytes;
    } catch (Exception e) {
        return false;
    }
}

这个方法可用于判断上传的图片是否超过 5MB，避免服务器资源被耗尽。

场景二：日志文件监控

监控日志文件是否增长过快，防止磁盘满：

public void checkLogFileGrowth(String logPath) {
    Path path = Paths.get(logPath);
    if (Files.exists(path)) {
        long size = Files.size(path);
        if (size > 1024 * 1024 * 100) { // 100MB
            System.out.println("警告：日志文件过大，建议归档！");
        }
    }
}

小结与建议

Java 实例 – 获取文件大小，看似简单，实则蕴含了对 I/O 操作、异常处理、单位转换、性能优化等多方面知识的综合运用。我们从最基础的 File.length() 开始，逐步过渡到更现代的 Files.size()，并结合实际应用场景，展示了如何写出既高效又健壮的代码。

• 对于简单项目，File.length() 足够；
• 对于现代 Java 项目，优先使用 Files.size()；
• 无论哪种方式，记得添加异常处理和文件存在性判断；
• 输出时建议将字节转换为用户可读的单位。

掌握这些技巧，不仅能让你在开发中游刃有余，也能为后续学习文件流、文件复制、批量处理等打下坚实基础。下次遇到“这个文件有多大”的问题，你已经知道答案了。