Как запустить Python-скрипт на macOS

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

Что важно знать заранее

• Файлы Python используют расширение .py.
• Современная практика — запускать скрипты на Python 3. macOS исторически поставлялся с Python 2.7, который устарел.
• Под «запуском» подразумевается выполнение скрипта в интерактивной или неинтерактивной среде с доступом к стандартному вводу/выводу и окружению.

Краткие определения:

• shebang — строка в начале скрипта, указывающая интерпретатор, например, #!/usr/bin/env python3.
• virtualenv — изолированное окружение для зависимостей проекта.
• pyenv — менеджер версий Python.

Python Launcher

Python Launcher — графическая утилита, которая устанавливается вместе с некоторыми дистрибутивами Python и позволяет запускать .py-файлы прямо из Finder.

Чтобы запустить скрипт через Python Launcher:

1. Найдите файл .py в Finder.
2. Правый клик по файлу и выберите “Получить сведения” чтобы увидеть путь к файлу, если нужно.

3. Правый клик по файлу и выберите “Открыть с помощью -> Python Launcher”.
4. Либо перетащите файл на иконку Python Launcher в Dock или в Applications.

Настройка Python Launcher

Python Launcher имеет окно настроек, где можно выбрать версию Python, включить вывод для отладки и указать поведение запуска.

Окно Preferences открывается автоматически при старте Python Launcher. Также можно открыть его вручную через меню “Python Launcher -> Preferences”. Если перетащить скрипт на иконку, удерживая клавишу Option, Preferences откроется перед выполнением — это полезно для однократной конфигурации запуска.

Важно: изменения в Preferences обычно глобальны и влияют на все будущие запуски, если не использовать модификатор Option для временных настроек.

Плюсы Python Launcher:

• Подходит для быстрых, одноразовых запусков GUI-ориентированных скриптов.
• Удобно для новичков, не знакомых с командной строкой.

Минусы:

• Меньше контроля над окружением и переменными среды.
• Не встроено управление версиями Python и виртуальными окружениями.

Использование Терминала

Для большинства профессиональных задач и при разработке вы будете запускать скрипты из Терминала. Этот метод даёт полный контроль над окружением, аргументами и перенаправлением ввода/вывода.

Как быстро получить путь до файла:

• В Finder: Option + Правый клик по файлу -> “Копировать <имя> как путь”.
• Перетащите файл в окно Терминала — путь вставится автоматически.

Обычный рабочий сценарий в Терминале:

1. Перейти в папку с проектом:

cd /путь/до/папки

2. Запустить скрипт через python3:

python3 script.py

Или, если в скрипте есть shebang и он помечен как исполняемый:

chmod +x script.py
./script.py

Почему предпочтительнее терминал:

• Управление версиями Python через pyenv или Homebrew.
• Использование virtualenv/venv для изоляции зависимостей.
• Скрипты можно запускать в cron, launchd или CI-системах.

Рекомендуемые способы установки Python 3

1. Homebrew (быстро и удобно):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install python

После установки Homebrew Python доступен через python3 и pip3.

2. Официальный установщик с python.org — удобен для тех, кто предпочитает графическую установку.
3. pyenv — если нужно управлять несколькими версиями Python параллельно.

Альтернативные подходы и когда они лучше

• shebang + chmod + ./script.py — удобно для скриптов, которые запускают на разных системах и не требуют явного вызова интерпретатора.
• pyenv + virtualenv — лучший выбор для разработки: позволяет фиксировать версию Python и зависимости проекта.
• Docker — если нужна воспроизводимая среда и изоляция на уровне контейнера.

Типичные ошибки и как их исправить

1. “Команда python3 не найдена”: установите Python 3 через Homebrew или официальный установщик.
2. Неправильная версия Python: используйте pyenv или явный путь к интерпретатору, например, /usr/local/bin/python3.
3. Ошибки с правами на выполнение: выполните chmod +x script.py.
4. Модули не найдены: активируйте виртуальное окружение и установите зависимости через pip.

Быстрая методика настройки рабочего окружения

1. Установите Homebrew.
2. Установите Python 3: brew install python.
3. Создайте проект и виртуальное окружение:

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

4. Запускайте скрипты через python3 или ./script.py.

Чек-лист перед запуском скрипта

• Установлен Python 3 и доступен как python3.
• Активировано виртуальное окружение при необходимости.
• Установлены все зависимости (pip install -r requirements.txt).
• Скрипт имеет правильный shebang, если запускаете как исполняемый файл.
• Проверены переменные окружения и пути.

Чек-лист для ролей:

• Разработчик: проверить версии, линтеры, тесты.
• Data Scientist: проверить виртуальное окружение и зависимости C-библиотек.
• Системный администратор: проверить конфигурацию cron/launchd и логирование.

Критерии приёмки

• Скрипт запускается без ошибок в чистом окружении после установки зависимостей.
• Вывод и коды возврата соответствуют документации скрипта.
• Скрипт корректно работает с указанными входными файлами и аргументами.

Шпаргалка команд

• Проверить версию Python:

python3 --version

• Установить пакет:

pip3 install package_name

• Создать виртуальное окружение:

python3 -m venv venv
source venv/bin/activate

• Сделать файл исполняемым и запустить:

chmod +x script.py
./script.py

Часто задаваемые вопросы

Как отличить системный Python от установленного вручную?

Используйте which python3 или command -v python3, чтобы увидеть путь до исполняемого файла. Системный Python обычно находится в /usr/bin, Homebrew — в /usr/local/bin или /opt/homebrew/bin.

Можно ли удалять системный Python 2 на macOS?

Не рекомендуется удалять системный Python, так как некоторые компоненты macOS или сторонние утилиты могут на него опираться. Лучше установить и использовать Python 3 параллельно.

Как запустить скрипт автоматически по расписанию?

Для одиночных задач используйте launchd (файлы plist) или cron. Для контейнеризированных задач используйте orchestrator или CI/CD.

Вывод

Запуск Python-скрипта на macOS прост: для быстрых запусков подойдёт Python Launcher, для разработки и автоматизации — Терминал с python3 и виртуальными окружениями. Рекомендуется установить современный Python 3 через Homebrew или официальный установщик и настроить окружение через venv или pyenv.

Важное: всегда проверяйте, какая версия Python используется, и изолируйте зависимости проекта.

Краткое содержание:

• Два способа запуска: GUI и Терминал.
• Терминал даёт больше контроля и подходит для разработки.
• Используйте virtualenv/pyenv для управления зависимостями и версиями.

Если у вас есть свой способ запуска Python-скриптов на macOS, поделитесь им в комментариях.