Класс File в Java: работа с файлами и каталогами

Строка File file = new File("report.txt"); выполняется без ошибок, но если такого файла ещё не было, он после неё не появится: file.exists() вернёт false, а file.length() — 0, и тоже без всякого исключения. Объект File — это только путь, а не сам файл, и большинство его методов сообщают о проблемах через false, 0 или null.

Класс File (java.io.File) — это представление пути к файлу или каталогу в файловой системе. В отличие от большинства классов ввода-вывода, он не работает с потоками и не читает содержимое файла: с его помощью проверяют, существует ли файл, узнают его размер, дату последнего изменения и права доступа (canRead(), canWrite()), создают, переименовывают и удаляют файлы и каталоги, получают список файлов каталога и перемещаются по иерархии подкаталогов.

Конструкторы класса File

Объект File создаётся одним из четырёх конструкторов: из полного пути, из пути родительского каталога и имени, из объекта File родительского каталога и имени или из URI. Ни один конструктор не обращается к диску и не создаёт файл — он только запоминает путь.

Разделитель каталогов можно писать как / — Java понимает его и в Windows, а при выводе пути заменяет на системный (\). Системный разделитель доступен в константе File.separator, но удобнее всего конструкторы с двумя параметрами: они сами подставляют нужный разделитель.

Методы класса File

Методы класса File делятся на две группы: информационные (имя, путь, размер, существование, тип, права) и операции над файловой системой (создание, переименование, удаление, получение списка файлов). Почти все операции не бросают исключений, а возвращают false — результат нужно проверять.

Информация о файле

Операции над файлами и каталогами

Полный список методов — в официальной документации java.io.File (Java 21).

Пример: получение информации о файле

Чтобы получить информацию о файле в Java, достаточно создать объект File и вызвать его информационные методы: getName(), getAbsolutePath(), exists(), length(), lastModified(). Ниже — программа, которая печатает все основные свойства файла.

Пример 1. Получение информации о файле

import java.io.File;
import java.time.Instant;

public class FileExample {
    public static void main(String[] args) {
        File file = new File("src/io/file.txt");

        System.out.println("Имя файла: " + file.getName());
        System.out.println("Путь: " + file.getPath());
        System.out.println("Абсолютный путь: " + file.getAbsolutePath());
        System.out.println("Родительский каталог: " + file.getParent());
        System.out.println(file.exists() ? "Файл/каталог существует." : "Файл/каталог не существует.");
        System.out.println(file.canWrite() ? "Доступен для записи." : "Недоступен для записи.");
        System.out.println(file.canRead() ? "Доступен для чтения." : "Недоступен для чтения.");
        System.out.println(file.isDirectory() ? "Каталог." : "Не каталог.");
        System.out.println(file.isFile() ? "Файл." : "Не файл.");
        System.out.println(file.isAbsolute() ? "Абсолютный путь." : "Не абсолютный путь.");
        System.out.println("Последнее изменение (мс): " + file.lastModified());
        System.out.println("Последнее изменение: " + Instant.ofEpochMilli(file.lastModified()));
        System.out.println("Размер: " + file.length() + " байт.");
    }
}

Вывод (Windows, проект в C:\projects\demo, файл размером 26 байт; время изменения у вас будет своё):

Имя файла: file.txt
Путь: src\io\file.txt
Абсолютный путь: C:\projects\demo\src\io\file.txt
Родительский каталог: src\io
Файл/каталог существует.
Доступен для записи.
Доступен для чтения.
Не каталог.
Файл.
Не абсолютный путь.
Последнее изменение (мс): 1793404800000
Последнее изменение: 2026-10-31T00:00:00Z
Размер: 26 байт.

Если заменить путь на "missing.txt" (такого файла нет), программа отработает без исключений, но значения станут «пустыми»:

Имя файла: missing.txt
Путь: missing.txt
Абсолютный путь: C:\projects\demo\missing.txt
Родительский каталог: null
Файл/каталог не существует.
Недоступен для записи.
Недоступен для чтения.
Не каталог.
Не файл.
Не абсолютный путь.
Последнее изменение (мс): 0
Последнее изменение: 1970-01-01T00:00:00Z
Размер: 0 байт.

Поэтому length() == 0 ещё не значит, что файл пустой: сначала проверяйте exists().

Работа с каталогами: mkdir, mkdirs, list, listFiles

Каталог в Java — тоже объект класса File; для него isDirectory() возвращает true. Каталог создают методами mkdir() (один уровень) и mkdirs() (вместе с недостающими родительскими), а его содержимое получают методами list() (имена) и listFiles() (объекты File).

Разница между mkdir() и mkdirs() видна, когда родительских каталогов ещё нет:

File dir = new File("out/reports/2026");
System.out.println(dir.mkdir());   // false - каталога out/reports нет
System.out.println(dir.mkdirs());  // true  - созданы out, out/reports и out/reports/2026
System.out.println(dir.mkdirs());  // false - каталог уже существует

Метод mkdirs() создаёт как сам каталог, так и все недостающие родительские каталоги. Повторный вызов возвращает false, поэтому «каталог есть» надёжнее проверять через dir.isDirectory(), а не по результату mkdirs().

Пример 2. Получение содержимого каталога

list() возвращает только имена, и для каждого имени пришлось бы заново собирать путь. listFiles() сразу возвращает объекты File, у которых можно вызвать isDirectory():

import java.io.File;
import java.util.Arrays;

public class DirList {
    public static void main(String[] args) {
        File catalog = new File("src");

        File[] files = catalog.listFiles();
        if (files == null) {
            System.out.println(catalog.getName() + " не является каталогом или недоступен");
            return;
        }
        Arrays.sort(files); // порядок listFiles() не гарантирован
        System.out.println("Папка " + catalog.getName());
        for (File file : files) {
            String type = file.isDirectory() ? "каталог" : "файл";
            System.out.println("  " + file.getName() + " - " + type);
        }
    }
}

Вывод (в каталоге src лежат подкаталог io и файл Main.java):

Папка src
  io - каталог
  Main.java - файл

Если каталога src нет, listFiles() вернёт null, и программа напечатает src не является каталогом или недоступен. Без проверки на null цикл for упал бы с NullPointerException.

Чтобы отобрать только нужные файлы, передайте в listFiles() фильтр — например, лямбду FileFilter:

File[] javaFiles = new File("src").listFiles(f -> f.isFile() && f.getName().endsWith(".java"));
// для каталога из примера выше: массив из одного элемента src\Main.java

Создание, переименование и удаление файла

Пустой файл создаёт метод createNewFile(), переименовывает или перемещает — renameTo(File dest), удаляет — delete(). Все три возвращают boolean; проверяемое исключение IOException бросает только createNewFile(), поэтому вызывающий его метод должен обработать исключение или объявить его в throws.

Пример 3. Что выведет этот код?

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

public class FileOperations {
    public static void main(String[] args) throws IOException {
        File file = new File("temp.txt");
        System.out.println(file.createNewFile());     // 1
        System.out.println(file.createNewFile());     // 2

        File renamed = new File("temp-old.txt");
        System.out.println(file.renameTo(renamed));   // 3
        System.out.println(file.exists());            // 4
        System.out.println(renamed.exists());         // 5
        System.out.println(renamed.delete());         // 6

        File out = new File("out");                   // каталог из примера с mkdirs, внутри out/reports
        System.out.println(out.delete());             // 7
    }
}

Вывод (файлов temp.txt и temp-old.txt до запуска нет):

true
false
true
false
true
true
false

Строка 2 — false: файл уже создан, повторно createNewFile() его не перезаписывает. Строка 4 — false, хотя переименование прошло успешно: объект file по-прежнему указывает на temp.txt, которого больше нет. Строка 7 — false: delete() не удаляет непустой каталог, сначала нужно удалить его содержимое.

Сам File не читает и не записывает содержимое файла — для этого объект File передают в конструктор потока: new FileInputStream(file), new FileReader(file). Чтение и запись разобраны в уроках Типы байтовых потоков и Классы символьных потоков.

File, Path и Files: что выбрать

В Java 7 появился пакет java.nio.file с интерфейсом Path (путь) и утилитным классом Files (операции). Они решают те же задачи, что и java.io.File, но при ошибке бросают исключение с понятной причиной вместо false, умеют копировать файлы и читать их содержимое. В новом коде для работы с файлами обычно выбирают Path и Files; File остаётся в старом коде и в API, которые принимают именно File.

Переход между API занимает один вызов: file.toPath() и path.toFile(). Поток Stream<Path> из Files.list() держит каталог открытым, его нужно закрывать — почему это важно, см. в уроке Конструкция try-with-resources.

Частые ошибки при работе с File

Большинство ошибок с классом File происходят из-за того, что он молча возвращает false или null вместо исключения, и из-за путей, зависящих от ОС и рабочего каталога. Ниже — что происходит в каждом случае и как исправить.