Как превратить Python-скрипт в исполняемый файл

Когда вы пишете скрипт на Python, он отлично работает у вас — потому что установлен сам Python и все нужные библиотеки. Но если захотите запустить этот скрипт где-то ещё (например, отправить другу или использовать на рабочем ноутбуке), начнутся танцы с установками и зависимостями. К счастью, есть способ собрать всё это в один готовый файл, который запускается сам по себе — как обычная программа. Сейчас покажу, как это сделать.

Шаг 1. Устанавливаем PyInstaller

Открываем терминал (или командную строку, или встроенный терминал в VS Code) и вводим команду:

pip install pyinstaller

Командную строку пока не закрывайте — она нам ещё понадобится.

Шаг 2. Переходим в нужную папку

Теперь нужно перейти туда, где лежит ваш скрипт. Используем команду cd, указав путь к нужной папке. Например:

cd /Users/username/Downloads

Если всё сделано правильно, в терминале появится имя этой папки — значит, мы внутри неё.

Как работает собранный файл

PyInstaller может собрать всё в:
— одну папку со всеми файлами;
— один файл .exe (или .app на macOS).

На самом деле, это почти одно и то же. Так, готовый файл при запуске:

1. Создаёт временную «виртуальную папку»;
2. Распаковывает в неё все нужные библиотеки и файлы;
3. Запускает в этой среде Python;
4. И уже внутри запускает ваш скрипт.

Так что результат — это просто компактная упаковка всего, что нужно, чтобы скрипт работал без лишних установок.

Шаг 3. Собираем исполняемый файл

Теперь — главное. Мы хотим получить не папку, а единый файл. Поэтому добавляем параметр --onefile. Команда будет такой:

pyinstaller --onefile scritp-name.py

Например:

pyinstaller --onefile gui.py

После этого в той же папке появятся две новые:
— build — можно не трогать,
— dist — вот в ней и лежит готовый .exe или .app.

Если вы работаете в Windows — получите исполняемый файл под Windows. Если на Mac — получите приложение для Mac.

Готовый файл может весить 20–30 мегабайт. Это нормально — он содержит не только ваш код, но и все библиотеки, которые понадобятся при запуске.

Шаг 4. Проверяем результат

Открываем получившийся файл двойным щелчком. Должно появиться терминальное окно, а чуть позже — интерфейс вашей программы (если он есть).

Всё работает? Значит, вы собрали всё правильно. Теперь этот файл можно запускать даже на компьютерах, где Python не установлен — никаких настроек, всё готово.

Если захотите — PyInstaller можно дополнительно настроить: убрать консоль, сменить иконку, настроить поведение приложения. Но это уже следующий уровень. Главное, вы знаете, с чего начать.