Обновление Python. Почему кодировка по умолчанию может сломать старые отчеты
В новой версии Python 3.15 кодировка UTF-8 стала стандартом по умолчанию для всех операций чтения и записи. Для современных систем это привычное поведение, но для старого кода это может обернуться ошибками или «кракозябрами» в документах.
До выхода версии 3.15 Python брал кодировку из настроек системы (локали). Если на сервере или компьютере бухгалтера стояла русская Windows, Python по умолчанию использовал CP1251. Теперь же, согласно правилам PEP 686, при вызове функции topen без явного указания кодировки интерпретатор всегда будет использовать UTF-8, независимо от настроек системы.
Такое изменение может привести к двум сценариям. Первый, программа просто упадет с ошибкой при попытке прочитать старый файл в другой кодировке. Второй сценарий опаснее: скрипт на Python 3.15 молча создаст файл в UTF-8, который старая система (например, Excel или бухгалтерская программа) прочитает с искаженными символами. Ошибки в логах не будет, но отчеты станут нечитаемыми.
Проблема особенно актуальна для Windows-машин, терминальных серверов и старых Linux-серверов с локалью ru_RU.CP1251. На современных Docker-образах и Linux с UTF-8-локалью изменений не произойдет, так как там стандарт уже был принят.
Чтобы найти уязвимые места в коде, можно использовать флаг twarn_default_encoding. Он заставляет Python выдавать предупреждение при каждом открытии файла без указания кодировки. Для автоматической проверки в тестах это предупреждение можно превратить в критическую ошибку, чтобы CI не пропустил небезопасный код.
Если ваш код работает с файлами, в которых не указана кодировка, при переходе на Python 3.15 он может перестать работать или испортить данные. Это значит, что при обновлении серверов нужно проверить все места, где открываются текстовые файлы, и явно прописать параметр encoding.
Что поменялось
В Python 3.15 кодировка по умолчанию изменена на UTF-8 для всех операций ввода-вывода, если не указано иное.
Источники · 1
Текст подготовила языковая модель по материалам источников.
