Как работать с текстовыми файлами в Python 3
Для работы с текстовыми файлами в Python используйте функцию open(): она открывает файл для чтения или записи. Укажите кодировку encoding='utf-8', а закрытие поручите конструкции with. Вы научитесь читать файл целиком и построчно, записывать новый текст и дополнять существующий. Примеры для Python 3 также показывают обработку ошибок пути, доступа и кодировки.
Что понадобится
Для этого руководства нужно установить Python 3. Дополнительные библиотеки не нужны: примеры используют встроенные средства языка.
Подготовьте текстовый редактор для Python, например Sublime Text. В нем удобно создать и скрипт, и обычный файл .txt. Если редактор уже установлен, используйте его.
Откройте терминал и узнайте версию доступного интерпретатора:
python --versionКоманда должна показать версию Python 3. В Linux и macOS интерпретатор часто вызывают командой python3, в Windows также используют py. Если команда python не найдена, попробуйте подходящий вариант с параметром --version. В командах запуска используйте то же имя интерпретатора.
Как Python обрабатывает текстовый файл
Обычный файл .txt хранит текст без оформления документа. CSV, HTML и JSON тоже содержат текст, но используют собственные правила структуры. В этой статье основное внимание будет уделено формату txt.
На диске файл хранится как последовательность байтов. Кодировка определяет, как Python преобразует эти байты в символы. При записи происходит обратное преобразование: Python кодирует строку в байты.
В текстовом режиме методы чтения возвращают строки str. Последовательность \n внутри строки Python обозначает перевод строки. Например, 'Monday\nTuesday\n' содержит два названия на отдельных строках.
Шаг 1 – Создание текстового файла
Создайте отдельную папку для учебных файлов, например python-files. В редакторе создайте файл days.txt со следующим содержимым:
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday
Sunday
После Sunday нажмите Enter, чтобы завершить последнюю строку. При сохранении файла выберите UTF-8 в списке кодировок редактора.
Если хотите подготовить файл без выбора кодировки в интерфейсе, откройте терминал в папке python-files и выполните команду. Она создаст days.txt в UTF-8 с нужными переносами строк. Если файл уже существует, команда заменит его содержимое.
python -c "from pathlib import Path; Path('days.txt').write_text('Monday\nTuesday\nWednesday\nThursday\nFriday\nSaturday\nSunday\n', encoding='utf-8')"Откройте days.txt: каждое название должно занимать отдельную строку.
Создайте рядом пустой файл files.py для кода Python. Убедитесь, что редактор сохранил именно эти расширения. Имена days.txt.txt и files.py.txt не подходят для примеров.
Шаг 2 – Открытие файла
Функция open() принимает путь, режим открытия и дополнительные параметры. Начните с чтения файла days.txt в кодировке UTF-8:
path = 'days.txt'
with open(path, 'r', encoding='utf-8') as days_file:
print(days_file.readline(), end='')Запишите пример в files.py. Отступ внутри with объединяет команды работы с открытым файлом. Когда выполнение покидает этот блок, Python автоматически закрывает файл.
Как указать путь
Относительный путь 'days.txt' отсчитывается от текущей рабочей папки процесса. Эта папка не обязательно совпадает с расположением скрипта. Чтобы увидеть ее, временно добавьте в начало files.py:
from pathlib import Path
print(Path.cwd())Для учебных примеров запускайте скрипт из папки python-files. Откройте терминал и перейдите туда командой cd. Например, в Windows путь к вашей папке можно указать так:
cd "C:/Users/Sammy/python-files"
python files.pyЗамените путь на расположение папки у себя. В Linux или macOS аналогичный переход выглядит так:
cd "/home/sammy/python-files"
python3 files.pyПри успешном чтении терминал покажет Monday. Если хотите открыть файл независимо от рабочей папки, укажите абсолютный путь. Для Windows подойдет raw-строка с префиксом r:
path = r'C:\Users\Sammy\python-files\days.txt'Префикс r сохраняет обратные слэши без обработки escape-последовательностей. Другой вариант для Windows – прямые слэши: 'C:/Users/Sammy/python-files/days.txt'.
Как выбрать режим открытия
Режим определяет доступные операции и судьбу существующего содержимого.
Пишите его без пробелов: 'r+', а не 'r +'.
| Режим | Что делает Python | Если файла нет |
|---|---|---|
'r' | Читает существующий файл, не изменяя его | Вызывает FileNotFoundError |
'w' | Открывает файл для записи, удаляя прежнее содержимое | Создает файл |
'a' | Дописывает текст в конец файла | Создает файл |
'x' | Создает новый файл для записи; существующий вызывает FileExistsError | Создает файл |
'r+' | Разрешает чтение и запись без очистки файла; запись идет с текущей позиции | Вызывает FileNotFoundError |
Буква 't' обозначает текстовый режим, включенный по умолчанию. Поэтому 'r' и 'rt' работают одинаково. Буква 'b' включает двоичный режим, например 'rb'. В нем Python читает байты, а параметр encoding не используется.
Почему стоит указывать кодировку
Без encoding выбор кодировки зависит от версии Python, настроек локали и режима UTF-8. Поэтому одинаковый скрипт может по-разному читать файл на разных компьютерах. Явное encoding='utf-8' устраняет эту зависимость для файлов UTF-8.
Указание кодировки не перекодирует существующий файл.
Если источник записал текст в Windows-1251, для чтения подойдет encoding='cp1251'. Используйте эту кодировку только для соответствующего файла, иначе получите ошибку или искаженные символы.
Параметры функции описаны в документации open().
Шаг 3 – Чтение файла
Методы чтения используют текущую позицию внутри открытого файла. Для небольшого текста удобно получить одну строку или список. Большой файл лучше обрабатывать последовательно, не загружая целиком в память.
Чтение целиком через read()
Метод read() без аргумента возвращает весь оставшийся текст одной строкой:
with open('days.txt', 'r', encoding='utf-8') as days_file:
days = days_file.read()
print(repr(days))Функция repr() показывает представление строки с видимыми escape-последовательностями. Для подготовленного файла результат выглядит так:
'Monday\nTuesday\nWednesday\nThursday\nFriday\nSaturday\nSunday\n'Вызов print(days, end='') выводит прочитанный текст без дополнительного перевода строки.
Чтение отдельных строк через readline()
Метод readline() возвращает следующую строку вместе с завершающим \n, если он есть. Каждый вызов сдвигает позицию чтения:
with open('days.txt', 'r', encoding='utf-8') as days_file:
print(repr(days_file.readline()))
print(repr(days_file.readline()))'Monday\n'
'Tuesday\n'На конце файла readline() возвращает пустую строку ''. Пустая строка внутри самого файла обычно читается как '\n'.
Получение списка через readlines()
Метод readlines() возвращает список оставшихся строк файла:
with open('days.txt', 'r', encoding='utf-8') as days_file:
lines = days_file.readlines()
print(lines)['Monday\n', 'Tuesday\n', 'Wednesday\n', 'Thursday\n', 'Friday\n', 'Saturday\n', 'Sunday\n']Оба метода, read() и readlines(), загружают оставшееся содержимое в память. Не используйте их без необходимости для больших файлов.
Построчный обход через for
Цикл for получает строки по очереди, не создавая список всего содержимого:
with open('days.txt', 'r', encoding='utf-8') as days_file:
for line in days_file:
print(line.rstrip('\n'))В текстовом режиме Python по умолчанию нормализует стандартные окончания строк до \n. Метод rstrip('\n') убирает завершающие переводы строки, сохраняя пробелы. Обычный rstrip() удалил бы и другие пробельные символы справа.
Возврат к началу через seek(0)
После полного чтения позиция находится на конце файла. Повторный read() вернет '', а readlines() – пустой список []. Для повторного чтения достаточно вызвать seek(0):
with open('days.txt', 'r', encoding='utf-8') as days_file:
days = days_file.read()
print(days_file.readlines())
days_file.seek(0)
print(repr(days_file.readline()))[]
'Monday\n'Каждый самостоятельный пример чтения открывает файл заново. Внутри одного блока with вызовы используют общую позицию.
Шаг 4 – Запись файла
Запишем новый файл, который включает название «Days of the Week» и дни недели. Исходный days.txt останется без изменений.
Режим 'w' удаляет прежнее содержимое сразу при открытии. Если new_days.txt содержит нужный текст, сначала сохраните его копию. Для запрета перезаписи замените 'w' на 'x'.
with open('days.txt', 'r', encoding='utf-8') as days_file:
days = days_file.read()
title = 'Days of the Week\n'
with open('new_days.txt', 'w', encoding='utf-8') as new_days:
new_days.write(title)
new_days.write(days)Метод write() записывает переданную строку без дополнительных разделителей. Поэтому заголовок заканчивается символом \n. После выполнения откройте new_days.txt: заголовок должен стоять перед Monday.
Дозапись в режиме 'a'
Режим 'a' сохраняет существующий текст и дописывает новый в конец. Добавьте к созданному файлу строку:
with open('new_days.txt', 'a', encoding='utf-8') as new_days:
new_days.write('End of list\n')Последней строкой станет End of list. Каждый повторный запуск этого примера добавляет еще одну такую строку.
Режим 'a' не вставляет перенос перед дописываемым текстом: предыдущая строка должна заканчиваться на \n.
Запись списка через writelines()
Метод writelines() записывает последовательность строк без автоматического добавления переводов строки:
lines = ['Monday\n', 'Tuesday\n', 'Wednesday\n']
with open('short_days.txt', 'w', encoding='utf-8') as days_file:
days_file.writelines(lines)Файл short_days.txt будет содержать три строки с названиями дней. Без \n элементы списка склеились бы в одну строку.
Шаг 5 – Закрытие файла
Конструкция with open(...) as f закрывает файл после завершения блока. Закрытие выполняется и при исключении внутри блока. При этом with не подавляет само исключение.
with open('days.txt', 'r', encoding='utf-8') as days_file:
days = days_file.read()
print(days_file.closed)Пример выведет True: файл закрыт. Переменная days по-прежнему содержит прочитанный текст. Повторное чтение через закрытый days_file вызовет ValueError.
При ручном закрытии разместите вызов close() в finally, чтобы файл закрылся и при ошибке чтения:
days_file = open('days.txt', 'r', encoding='utf-8')
try:
days = days_file.read()
finally:
days_file.close()Для обычных скриптов выбирайте with: он короче и управляет ресурсом автоматически. Закрытие файла сбрасывает буфер записи и освобождает связанные ресурсы.
Как обработать ошибки открытия и чтения
Ошибочный путь, запрет доступа и неподходящая кодировка требуют разных действий. Оберните в try весь блок with: ошибка декодирования часто возникает при чтении, а не при открытии.
from pathlib import Path
path = Path('days.txt')
try:
with open(path, 'r', encoding='utf-8') as days_file:
days = days_file.read()
except FileNotFoundError:
print(f'Файл не найден: {path.resolve()}')
except PermissionError:
print(f'Нет доступа к файлу: {path.resolve()}')
except UnicodeDecodeError:
print('Не удалось прочитать файл как UTF-8. Проверьте его кодировку.')
else:
print(days, end='')FileNotFoundError– сравните выведенный полный путь с расположениемdays.txt. Исправьте путь или перенесите файл в рабочую папку.PermissionError– убедитесь, что путь указывает на доступный файл. Для учебного примера перенесите его в собственную пользовательскую папку.UnicodeDecodeError– откройте файл в редакторе с его исходной кодировкой. Если символы отображаются правильно, сохраните копию в UTF-8 и прочитайте ее.
Чтобы проверить обработку отсутствующего файла, временно измените имя на missing_days.txt. Если такого файла нет, программа покажет сообщение с полным путем. Затем верните days.txt.
Не добавляйте errors='ignore' ради исчезновения ошибки кодировки: этот параметр может незаметно удалить символы при чтении.
Неправильная кодировка иногда дает искаженный текст без исключения: проверяйте содержимое, особенно кириллицу.
Шаг 6 – Проверка кода
Замените содержимое files.py полным примером. Он прочитает исходный файл, создаст новый и выведет записанный текст. Запускайте его из папки с days.txt.
Пример перезаписывает new_days.txt, включая строку, добавленную при упражнении с дозаписью. Сохраните копию результата, если хотите оставить ее.
from pathlib import Path
path = Path('days.txt')
new_path = Path('new_days.txt')
title = 'Days of the Week\n'
try:
with open(path, 'r', encoding='utf-8') as days_file:
days = days_file.read()
with open(new_path, 'w', encoding='utf-8') as new_days:
new_days.write(title)
new_days.write(days)
except FileNotFoundError as error:
print(f'Файл или папка не найдены: {error.filename}')
except PermissionError as error:
print(f'Нет доступа: {error.filename}')
except UnicodeDecodeError:
print('Исходный файл не удалось прочитать как UTF-8.')
except OSError as error:
print(f'Ошибка работы с файлом: {error}')
else:
print(title + days, end='')Сохраните скрипт и выполните команду в терминале:
python files.pyЕсли ваш интерпретатор запускается через python3 или py, замените имя команды. Для подготовленного days.txt терминал покажет следующий текст:
Days of the Week
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday
Sunday
Откройте new_days.txt в редакторе и сравните его содержимое с выводом. Между заголовком и Monday нет пустой строки. Вызов print(title + days, end='') выводит готовый текст без лишнего переноса.
Если запись завершилась ошибкой, файл назначения мог сохраниться лишь частично. Исправьте причину и запустите скрипт повторно: исходный days.txt программа не меняет.
Какой способ использовать в своем скрипте
Для небольшого файла выбирайте read(), если нужен весь текст. Для последовательной обработки строк используйте for line in f. Метод readlines() пригодится, когда нужен именно список.
Режим 'w' заменяет содержимое, 'a' дополняет его, а 'x' защищает существующий файл от перезаписи. Во всех текстовых примерах указывайте подходящую кодировку и используйте with.
Первые упражнения с записью выполняйте на копиях файлов. Даже правильно написанный вызов open(..., 'w') удалит прежний текст до первой команды write().
Популярное за неделю
- Как создать сайт самому в 2026: 4 способа + пошаговая инструкция 34 мин чтения
- Лучшие конструкторы сайтов для самостоятельного запуска 23 мин чтения
- Как читать и записывать файлы Word в Python с помощью python-docx 5 мин чтения
- Как работает функция print в Python: вывод, разделители и запись в файл 2 мин чтения
- Как читать Excel в Python через pandas.read_excel() и сохранять результат 6 мин чтения
- Как работать с MySQL из Python: пособие с примерами кода 14 мин чтения
Комментарии