FileNotFoundError в Python: файл не нашёлся

Работа с файлами — первое место, где программа встречается с внешним миром: файл кто-то мог переименовать, удалить, назвать по-другому. Ошибки тут не баги кода, а свойства реальности, и для них у Python есть целое семейство — OSError, о котором говорилось в уроке об иерархии. Его самый известный ребёнок — FileNotFoundError: файл не нашёлся.

Файл, которого нет

f = open('нет-такого-файла.txt', encoding='utf-8')

В сообщении три части: тип ошибки, системный код и путь, по которому искали. Код меняется от системы к системе, поэтому в собственных сообщениях его не печатают — а вот путь из e.filename стабилен и годится для журналов. Сама ошибка честная: ни файла рядом, ни файла по указанному пути не нашлось, и придумывать содержимое open не станет.

Ловим FileNotFoundError

try:
    open('нет-такого-файла.txt', encoding='utf-8')
except FileNotFoundError as e:
    print('поймали', type(e).__name__)
    print('файл:', e.filename)

поймали FileNotFoundError
файл: нет-такого-файла.txt

Ловится ошибка как любая другая, а объект несёт полезные атрибуты: filename — путь, по которому искали. Этого хватает, чтобы не падать молча, а сообщить пользователю, какого именно файла не хватило: «файл отчёта за март не найден» звучит лучше, чем traceback на полэкрана.

try:
    open('нет.txt', encoding='utf-8')
except OSError as e:
    print('OSError поймал за ребёнка:', type(e).__name__)

OSError поймал за ребёнка: FileNotFoundError

Файл не нашёлся, а напечатанное имя — FileNotFoundError: родительская ветка перехватила детскую ошибку, сохранив её настоящий тип. Ветку по OSError пишут, когда реакция одна на все системные проблемы; когда «нет файла» нужно отличить от «нет прав», ловят точное имя — FileNotFoundError или PermissionError.

Открытый файл положено закрывать даже при сбое — за это отвечает with, а про его связь с finally из шестого урока стоит перечитать на досуге. Дальше — практика: примеры этого урока сами создают себе файлы, читают их и убирают за собой.

Самодостаточный пример: создать, прочитать, убрать

import os

path = 'urok13_notes.txt'
with open(path, 'w', encoding='utf-8') as f:
    f.write('первая строка\nвторая строка\n')

with open(path, encoding='utf-8') as f:
    content = f.read()
print('прочитано', len(content), 'символов')
print(content.splitlines()[0])

os.remove(path)
print('файл существует?', os.path.exists(path))

прочитано 28 символов
первая строка
файл существует? False

Такой порядок — создать, использовать, удалить — делает пример честным на любой машине: он не зависит от файлов, которых у читателя может не быть, и не оставляет мусора. len(content) насчитал двадцать восемь символов — две строки по тринадцать плюс два перевода строки. Метод splitlines() рвёт содержимое на строки без хвостовых переводов, а os.path.exists после удаления подтверждает: файла больше нет.

exists: спросить до действия

import os

path = 'urok13_config.txt'

if os.path.exists(path):
    print('конфиг на месте, читаем')
else:
    print('конфига нет — работаем с умолчаниями')

try:
    open(path, encoding='utf-8')
except FileNotFoundError:
    print('open подтвердил: файла нет')

конфига нет — работаем с умолчаниями
open подтвердил: файла нет

os.path.exists отвечает на вопрос «есть ли файл» без всяких исключений — проверка перед действием, стиль LBYL. У неё есть тонкость, из четырнадцатого урока об EAFP: проверка exists отвечает на вопрос до действия, а try с FileNotFoundError — после него: между проверкой и открытием файл может исчезнуть. В одиночном скрипте разница незаметна, но принцип стоит знать заранее.

На практике чаще всего нужен каркас «если файл есть — прочитать, если нет — умолчание». Он собирается через try с запасным значением:

import os

def read_config(path, default='пусто'):
    try:
        with open(path, encoding='utf-8') as f:
            return f.read().strip()
    except FileNotFoundError:
        return default

path = 'urok13_conf.txt'
print('конфиг:', repr(read_config(path)))
with open(path, 'w', encoding='utf-8') as f:
    f.write('режим=тёмный\n')
print('конфиг:', repr(read_config(path)))
os.remove(path)

конфиг: 'пусто'
конфиг: 'режим=тёмный'

Функция возвращает содержимое файла или запасное значение — и вызывающий код не знает про системные ошибки вовсе. strip() срезает хвостовой перевод строки, repr в печати показывает границы значения, чтобы пустую строку не спутать с пустотой в терминале.

Файл — внешние данные, и внешние данные не обязаны существовать: FileNotFoundError делает это свойство видимым и управляемым. Два стиля обхода — спросить заранее или действовать и ловить — встретятся ещё раз в уроке об EAFP, а практику с грязными файлами ждите в финальном проекте раздела.