Чтобы установить PyGame, откройте терминал и выполните команду pip install pygame — библиотека скачается из каталога PyPI и подключится к Python автоматически. Скачивать дистрибутив с сайтов по запросу «pygame скачать» не нужно: установщика в привычном смысле у библиотеки нет, всё делает pip. Ниже — точные команды для Windows, macOS и Linux, проверка версии и разбор ошибки ModuleNotFoundError: No module named ‘pygame’, на которой спотыкается почти каждый новичок. Если вы только присматриваетесь к языку, начните с обзора стоит ли учить Python, а сюда вернётесь за практикой.
CheckroiПодборка курсов по Python570 курсов • 46 школСравните цены, школы, программу и найдите выгодные предложения по обучениюСравнить→
Установка PyGame через pip: пошаговая инструкция
PyGame — внешняя библиотека, в стандартную поставку Python она не входит. Ставится одной командой через менеджер пакетов pip, который идёт в комплекте с Python начиная с версии 3.4.
- Откройте терминал: в Windows нажмите Win + R, введите
cmdи нажмите Enter; в macOS запустите приложение «Терминал»; в Linux — любую консоль. - Убедитесь, что Python установлен: команда
python --version(в macOS и Linux —python3 --version) должна вывести номер версии, напримерPython 3.14.3. - Выполните команду установки для своей системы из таблицы ниже.
- Дождитесь строки
Successfully installed pygame-2.6.1— установка занимает меньше минуты.
| Система | Команда |
|---|---|
| Windows | py -m pip install pygame |
| macOS и Linux | python3 -m pip install pygame |
| Активированное виртуальное окружение | pip install pygame |
Форма python -m pip надёжнее короткой pip pygame-команды: она ставит библиотеку ровно в тот интерпретатор, который вы вызвали. Когда на компьютере живут две-три версии Python, именно это спасает от ошибки «установил, а импорт не работает».
Работаете в виртуальном окружении — сначала активируйте его, потом ставьте библиотеку. Иначе pip положит пакет в системный Python, а проект его не увидит.
Отдельный терминал не обязателен и для тех, кто пишет код в IDLE или Thonny. В IDLE командной строки нет — установите пакет через системный терминал той же командой, и редактор его подхватит. В Thonny ещё проще: меню «Инструменты → Управление пакетами», в поиске набираете pygame и нажимаете «Установить» — этот способ любят в школах, потому что терминал не нужен вовсе.
Как проверить, что PyGame установился
Самый быстрый способ — импортировать библиотеку и вывести версию одной командой:
python3 -c "import pygame; print(pygame.version.ver)"Реальный вывод при успешной установке выглядит так:
pygame 2.6.1 (SDL 2.32.70, Python 3.14.3)
Hello from the pygame community. https://www.pygame.org/contribute.html
2.6.1Приветствие от сообщества — признак того, что библиотека PyGame загрузилась. Есть и другие способы проверки:
pip show pygame— покажет версию, описание и путь, куда установлен пакет;python3 -m pygame.examples.aliens— запустит встроенную демо-игру: если открылось окно с инопланетянами, всё работает;- минимальное окно своими руками — код ниже.
import pygame
pygame.init()
screen = pygame.display.set_mode((640, 480))
pygame.display.set_caption("Моя первая игра")
print(pygame.version.ver)
pygame.quit()Скрипт создаёт окно 640 × 480, задаёт заголовок и печатает 2.6.1. Если он отработал без ошибок — PyGame установлен и готов к работе. Сохранить и запустить файл удобнее всего в редакторе — как это сделать, мы разбирали в инструкции как создать и запустить файл Python в VS Code.
Ошибка ModuleNotFoundError: почему import pygame не работает
Классическая ситуация: установка прошла с Successfully installed, а при запуске скрипта Python выдаёт:
ModuleNotFoundError: No module named 'pygame'Причина всегда одна: скрипт запускается не тем интерпретатором, в который вы поставили библиотеку. Вот четыре типовых сценария и решения.
| Ситуация | Решение |
|---|---|
| На компьютере несколько версий Python | Ставьте через python3 -m pip install pygame, вызывая ту же команду, которой запускаете скрипт |
| VS Code использует другой интерпретатор | Нажмите Ctrl + Shift + P → «Python: Select Interpreter» и выберите тот Python, куда установлен пакет |
| Виртуальное окружение не активировано | Активируйте: venvScriptsactivate в Windows, source venv/bin/activate в macOS и Linux — и переустановите пакет |
| PyCharm создал проекту своё окружение | Откройте Settings → Project → Python Interpreter и добавьте pygame кнопкой «+» прямо из интерфейса |
Проверить, куда именно смотрит интерпретатор, помогает команда python3 -m pip show pygame: строка Location показывает каталог пакета. Если команда отвечает «Package(s) not found» — в этом интерпретаторе библиотеки нет, ставьте заново.
Другие ошибки установки PyGame и их решения
Кроме пропавшего модуля, у новичков стабильно всплывают ещё три проблемы (pygame install error в разных вариантах).
Ошибка «getting requirements to build wheel»
Появляется, когда pip пытается собрать старую версию PyGame под свежий Python, для которого нет готовой сборки. Обновите pip и поставьте актуальную версию:
python3 -m pip install --upgrade pip
python3 -m pip install -U pygameФлаг -U обновляет пакет до последней версии, даже если какая-то уже стоит. На август 2026 года актуальная версия — PyGame 2.6.1, она собрана под все свежие версии Python вплоть до 3.14.
Команда pip не найдена
Windows пишет «»pip» не является внутренней или внешней командой» — значит, путь к Python не прописан в системе. Два выхода: использовать форму py -m pip install pygame вместо голого pip либо переустановить Python, отметив галочку Add python.exe to PATH в первом окне установщика.
Недостаточно прав для установки
Если система отвечает «Permission denied» или «Defaulting to user installation», добавьте флаг --user: команда python3 -m pip install --user pygame установит пакет в домашний каталог без прав администратора.
У PyGame есть активно развиваемый форк — pygame-ce (Community Edition). Команды у него те же, код совместим, но ставить обе версии сразу нельзя: они конфликтуют. Для учёбы подойдёт любая, начинайте с классической.
Как поставить конкретную версию или переустановить PyGame
Иногда нужна не последняя версия: учебник написан под старый релиз или проект требует строго определённую сборку. Версия указывается через два знака равенства:
python3 -m pip install pygame==2.5.2Здесь есть подвох, о котором редко предупреждают: старые версии PyGame не собираются под свежие версии Python. Мы проверили: на Python 3.14 команда выше падает с ошибкой Failed to build 'pygame' when getting requirements to build wheel — готовой сборки 2.5.2 под этот интерпретатор просто нет. Если учебный проект требует старый PyGame, ставьте его на Python той эпохи, например 3.11 или 3.12.
Если установка сломалась на середине или библиотека ведёт себя странно, надёжнее всего снести пакет и поставить заново:
- Удалите пакет:
python3 -m pip uninstall pygameи подтвердите клавишей Y. - Установите свежую копию без кеша:
python3 -m pip install --no-cache-dir pygame. - Проверьте версию:
python3 -c "import pygame; print(pygame.version.ver)".
Флаг --no-cache-dir заставляет pip скачать пакет заново, а не доставать из локального кеша — это лечит случаи, когда при первой загрузке файл побился.
Где освоить Python системно
Установка библиотеки — первые пять минут пути. Дальше начинается интересное: первое окно и игровой цикл, обработка событий, спрайты, — а для этого нужен уверенный базовый Python: работа со списками, циклы, функции.
Быстрее всего база набирается на структурированных курсах с практикой и проверкой кода наставником. Мы собрали каталог курсов по Python — сравните программы и цены школ в одном месте.
| Курс | Школа | Стоимость со скидкой | В рассрочку | Длительность | Обзор курса от Checkroi |
|---|---|---|---|---|---|
| Профессия «Python-разработчик» Перейти на сайт курса |  Skillbox | 157 335 ₽ | 5987 ₽/мес. | 10 месяцев | Обзор курса |
| Fullstack-разработчик на Python Перейти на сайт курса |  Нетология | 175 800 ₽ | 7125 ₽/мес. | 21 месяц | Обзор курса |
| Разработчик на Python Перейти на сайт курса | Нетология | 198 000 ₽ | 5500 ₽/мес. | 6 месяцев | Обзор курса |
| Автоматизированное тестирование на Python Перейти на сайт курса | Skillbox | 118 666 ₽ | 4108 ₽/мес. | 9 месяцев | Обзор курса |
| Программирование на Python ПРО Перейти на сайт курса | Skillbox | 119 600 ₽ | 250 000 ₽/мес. | 17 месяцев | Обзор курса |
Больше программ — в полном каталоге курсов по Python
