Новый файл Python: инструкция по созданию

Раздел: Работа с файлами -> Файловый ввод-вывод

Основное решение: функция open() с режимом 'x' или 'w'

Наиболее универсальный и рекомендуемый способ создания нового файла в Python - использование встроенной функции open() в сочетании с менеджером контекста with. Режим 'x' (исключительное создание) позволяет создать файл, только если он ещё не существует. Если файл уже есть, возникает исключение FileExistsError. Режим 'w' создаёт файл при его отсутствии либо перезаписывает существующий. Выбор режима зависит от необходимости защитить данные от случайной перезаписи.

with open('new_file.txt', 'x') as f:
    pass  # пустой файл создан

ввод программ на python (ввод данных в программе python)

Если требуется сразу записать данные, это делается внутри блока with:

with open('data.txt', 'w') as f:
    f.write('Hello, world!')

Python file io (ввод-вывод файлов в python)

После выхода из контекста файл автоматически закрывается, что предотвращает утечку ресурсов.

Типичные ошибки и их решение

FileExistsError - возникает при использовании режима 'x', если файл уже существует. Решение: предварительно проверить наличие файла с помощью os.path.exists() или переключиться на режим 'w'/'a'.
PermissionError - недостаточно прав для создания файла в указанной директории. Решение: запустить скрипт с соответствующими правами или изменить путь на доступную папку.
FileNotFoundError - если указанный в пути каталог не существует. Решение: предварительно создать каталог через os.makedirs().

Альтернативные способы создания файла

Как создать пустой файл без записи данных и без необходимости открывать его на запись?

open('empty_file.txt', 'a').close()

Python temp files (временные файлы в python)

Режим 'a' (дозапись) создаёт файл, если его нет, и не удаляет существующее содержимое. Метод .close() сразу закрывает файл. Такой подход менее предпочтителен, так как файл может остаться открытым при возникновении исключения до вызова .close().

Как создать файл, используя объектно-ориентированный подход?

Модуль pathlib предоставляет класс Path с методом touch(), который создаёт пустой файл, если он не существует. Этот способ считается более современным и читаемым.

from pathlib import Path

Path('new_file.txt').touch()

Python index files (индексация файлов в python)

Метод touch() также может обновлять время последнего доступа и изменения существующего файла. Для исключительного создания без обновления времени используется комбинация с проверкой существования.

Как создать файл с помощью низкоуровневого системного вызова?

import os

fd = os.open('low_level.txt', os.O_CREAT | os.O_WRONLY | os.O_EXCL)
os.close(fd)

Флаг os.O_CREAT указывает на создание, os.O_EXCL - исключительное создание (вызовет FileExistsError при наличии файла). Этот метод редко используется в прикладном коде из-за необходимости ручного управления дескриптором.

Проблемы при использовании альтернатив

В режиме 'a' без менеджера контекста файл может остаться открытым при ошибке. Рекомендуется всегда использовать with.
Метод touch() не выбрасывает исключение, если файл существует, а просто обновляет метаданные. Если требуется гарантированно новое создание, необходимо предварительно проверять существование.
Низкоуровневый вызов os.open() не поддерживает текстовые режимы и кодировки, требуется дополнительная обёртка через os.fdopen().

- Python config files (конфигурационные файлы в python)

- Python copy file (копирование файла в python)

- Python log file (логирование в файл в python)

Расширенные примеры создания файлов

1. Создание файла с записью нескольких строк

Пример

lines = ['Первая строка\n', 'Вторая строка\n', 'Третья строка\n']
with open('multiline.txt', 'w', encoding='utf-8') as f:
    f.writelines(lines)

Файл multiline.txt создан и содержит три строки.

2. Создание файла в указанной директории с проверкой существования каталога

Пример

import os

directory = 'data/subdir'
filename = 'output.log'
full_path = os.path.join(directory, filename)

os.makedirs(directory, exist_ok=True)
with open(full_path, 'w') as f:
    f.write('Log entry')

Каталог data/subdir создан, внутри него создан файл output.log.

3. Использование модуля tempfile для создания временного файла

Пример

import tempfile

with tempfile.NamedTemporaryFile(mode='w', suffix='.txt', delete=False) as tmp:
    tmp.write('Временные данные')
    temp_path = tmp.name
print(f'Временный файл создан: {temp_path}')

Временный файл создан: /tmp/tmpXXXXXX.txt (путь может отличаться). Файл не удаляется после выхода из контекста благодаря параметру delete=False.

4. Создание файла с указанием кодировки и обработкой ошибок

Пример

try:
    with open('encoded.txt', 'x', encoding='cp1251') as f:
        f.write('Текст в кодировке Windows-1251')
except FileExistsError:
    print('Файл уже существует.')

Если файла не было, он создаётся с содержимым в кодировке cp1251. При повторном запуске выводится сообщение об ошибке.

5. Создание файла с определёнными правами доступа (только Unix)

Пример

import os

file_path = 'restricted.txt'
# Создаём файл с правами 600 (только владелец может читать/писать)
fd = os.open(file_path, os.O_CREAT | os.O_WRONLY | os.O_EXCL, 0o600)
os.close(fd)

Файл restricted.txt создан с правами '-rw-------'.

6. Массовое создание файлов с разными именами

Пример

import os

prefix = 'batch_'
for i in range(5):
    filename = f'{prefix}{i}.txt'
    Path(filename).touch()
    print(f'Создан файл: {filename}')

Создан файл: batch_0.txt
Создан файл: batch_1.txt
...
Создан файл: batch_4.txt

7. Использование pathlib для создания файла с записью данных

Пример

from pathlib import Path

file_path = Path('example') / 'notes.txt'
file_path.parent.mkdir(parents=True, exist_ok=True)
file_path.write_text('Заметки', encoding='utf-8')

Создана папка example, внутри неё файл notes.txt с текстом 'Заметки'.

Создание нового файла Python - comments

Python new file (python)