Ключевые различия, чаще всего ломающие совместимость:
- Строки и байты: в Python $2$ типы «text» и «bytes» смешивались; в Python $3$ строка — unicode (`str`), байты — `bytes`. Ошибки при конкатенации/сравнении и при вводе/выводе в бинарных API.
- Ввод: `raw_input()` → `input()`; в Python $2$ `input()` выполнял eval.
- `print`: в Python $2$ — оператор, в Python $3$ — функция (`print()`).
- Деление целых чисел: в Python $2$ `1/2 == 0`, в Python $3$ `1/2 == 0.5`. Для целочисленного деления используется `//`.
- Итераторы/коллекции: `range`, `map`, `filter`, `zip` возвращают итераторы в $3$ (в $2$ — списки или `xrange`). `dict.keys()/values()/items()` — view-объекты в $3$.
- Типы чисел: `long` убран — теперь все целые `int` (без отдельного типа `long`).
- Исключения: синтаксис `except Exception, e:` → `except Exception as e:`.
- Метаклассы: новый синтаксис (`class C(metaclass=Meta):`) vs Python $2$ форма.
- Стандартная библиотека: модули переименованы/реорганизованы (например, `urllib`, `ConfigParser` → `configparser`, `Queue` → `queue`, `cPickle` → `pickle`).
- Сравнения разнородных типов: в Python $3$ прямое сравнение разных несопоставимых типов вызывает TypeError.
- Кодировка исходников: по умолчанию UTF-8 в $3$; в $2$ часто ASCII без явной декларации.
- Файловый ввод/вывод: `open()` по умолчанию текстовый с `str`-строками в $3$; требуется явное `encoding` при чтении/записи юникода.
- Удалены некоторые API/функции и поведение C-расширений (C-API изменения, CPython 3.x ABI).
Поэтапная стратегия миграции с минимальным риском:
$1$ Подготовка и покрытие тестами
- Создайте (или расширьте) набор юнит/интеграционных тестов, покрывающих ключевые сценарии; стремитесь к высокой покрываемости критичных модулей.
$2$ Анализ и статическая проверка
- Запустите линтеры, `pylint`, `flake8`. Найдите потенц. проблемы с круговыми импортами, неявной зависимостью на `str`/`bytes`.
$3$ Вариант «поддержка двух версий» (по желанию)
- Если нужно плавное переключение, подготовьте код, совместимый с $2$ и $3$ с помощью `six`, `future`/`futurize` или `python-modernize`. Добавьте в модули:
- `from __future__ import print_function, division, absolute_import, unicode_literals`
- Явные `b"..."`/`u"..."` там, где требуется.
$4$ Автоматическое преобразование синтаксиса
- Прогоните `futurize`/`modernize` или `2to3` для первичного преобразования синтаксиса; вручную проверьте изменения, особенно для строк/байтов и импортов стандартной библиотеки.
$5$ Обновление зависимостей
- Обновите/проверяйте версии сторонних пакетов на совместимость с Python $3$. Замените неподдерживаемые библиотеки.
$6$ Настройка CI для многоверсионного тестирования
- Поднимите тесты в CI (например, `tox` или matrix в GitHub Actions) для обеих версий (если делаете двойную поддержку) или для целевой версии $3$. Исправляйте ошибки, найденные в CI.
$7$ Исправление runtime-проблем
- Исправьте конкретные источники проблем:
- Явно указывайте `encoding='utf-8'` при `open()` для текстовых файлов.
- Приводите байты/строки при работе с сетями/файлами/сериализацией (`.encode()` / `.decode()`).
- Замените использование `dict.iter*`/`xrange`/ожидание списков: применяйте `list()` при необходимости.
- Используйте `six.moves` или новые имена модулей для переноса импортов.
- Перепишите сравнения/сортировки, использующие `cmp` — используйте `key`-функции.
$8$ Тестирование в staging/канареечный выпуск
- Запустите сервисы на Python $3$ в staging; мониторьте логи и метрики; делайте канареечную/поэтапную выкладку.
$9$ Переключение и удаление совместимости
- После стабильной работы удалите shim-код и зависимости для Python $2$, уберите `__future__`-импорты, почистите код.
Контрольный список горячих точек при исправлениях:
- Ввод/вывод и файлы: явно указывайте `encoding`.
- Сетевые и бинарные API: работайте с `bytes`.
- Сериализация (pickle/json): убедитесь, что кодирует/декодирует в правильной форме.
- Интерфейсы с внешними системами (subprocess, DB драйверы): проверьте ожидания типов.
- Юнит-тесты: добавьте проверки на типы возвращаемых значений.
Инструменты, которые полезно использовать:
- `futurize`, `python-modernize`, `2to3`
- `six`, `future`
- `tox`, CI (GitHub Actions, GitLab CI)
- `pytest`, покрытие (`coverage`)
Если нужно, могу дать конкретный чеклист для вашего проекта (какие файлы/модули смотреть в первую очередь) — пришлите структуру репозитория.