Python

Как установить pygame на Python и проверить, что библиотека работает

pygame — библиотека для простых 2D-игр на Python. С ее помощью можно открыть окно, рисовать фигуры, двигать объекты, обрабатывать клавиатуру и постепенно собрать игру вроде Pong, Snake или аркады с персонажем

Главная ошибка новичков — ставить pygame одной командой, а запускать код другим Python. Поэтому устанавливать лучше через python -m pip, чтобы пакет попал именно в тот интерпретатор, который вы используете

Короткий ответ

В терминале выполните

python -m pip install pygame

Если на вашем компьютере Python запускается как python3, используйте

python3 -m pip install pygame

На Windows часто удобно так

py -m pip install pygame

Проверьте установку

python -m pygame.examples.aliens

Если открылось игровое окно, pygame установлен и работает

Лучше ставить pygame в виртуальное окружение

Создайте папку проекта

mkdir pygame_lesson
cd pygame_lesson

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

python -m venv .venv

Активируйте его на Windows

.venv\Scripts\activate

На macOS и Linux

source .venv/bin/activate

Теперь установите pygame

python -m pip install pygame

Так библиотека будет лежать внутри проекта, а не в системном Python

Как проверить pygame через import

Создайте файл check_pygame.py

import pygame

print("pygame установлен")
print("Версия:", pygame.version.ver)

Запустите файл

python check_pygame.py

Если вы видите версию pygame, установка прошла нормально

Первый экран pygame

Теперь создайте файл main.py

import pygame

pygame.init()

screen = pygame.display.set_mode((640, 360))
pygame.display.set_caption("Первое окно pygame")

running = True
while running:
    for event in pygame.event.get():
        if event.type == pygame.QUIT:
            running = False

    screen.fill((30, 40, 60))
    pygame.draw.circle(screen, (255, 200, 80), (320, 180), 60)
    pygame.display.flip()

pygame.quit()

Запустите

python main.py

Должно открыться окно с кругом. Если окно открылось и закрывается по крестику, pygame работает достаточно хорошо для первых уроков

Что делает этот код

pygame.init() запускает внутренние модули pygame. pygame.display.set_mode((640, 360)) создает окно размером 640 на 360 пикселей. Цикл while running нужен, чтобы окно не закрывалось сразу после запуска

Событие pygame.QUIT появляется, когда пользователь закрывает окно. Если его не обработать, программа может зависнуть или закрываться некрасиво. screen.fill() заливает фон цветом, pygame.draw.circle() рисует круг, а pygame.display.flip() обновляет экран

Ошибка ModuleNotFoundError

Если после установки вы видите ошибку

ModuleNotFoundError: No module named 'pygame'

значит pygame установлен не в тот Python или вообще не установлен в активном окружении. Проверьте, каким Python запускается файл

python --version
python -m pip show pygame

Если pip show pygame ничего не показывает, установите еще раз

python -m pip install pygame

Важно запускать все команды в одном и том же терминале и в активированном окружении, если вы его используете

Ошибка с pip

Если команда pip install pygame не работает, используйте вариант через Python

python -m pip install pygame

Так меньше шансов, что pip относится к другой версии Python. На macOS может понадобиться python3

python3 -m pip install pygame

Ошибка с окном на macOS или Linux

Иногда pygame устанавливается, но окно не открывается в удаленной среде, внутри контейнера или на сервере без графического интерфейса. Pygame рассчитан на локальный запуск с экраном, поэтому проверяйте его на своем компьютере, а не в консольной среде без рабочего стола

Если вы работаете в редакторе, попробуйте запустить файл из обычного терминала. Так легче увидеть настоящую ошибку

Мини-практика

После первого окна поменяйте цвет фона и координаты круга

screen.fill((10, 90, 70))
pygame.draw.circle(screen, (250, 250, 250), (120, 100), 40)

Потом попробуйте заменить круг на прямоугольник

pygame.draw.rect(screen, (255, 120, 120), (240, 120, 160, 90))

Если фигуры меняются после перезапуска программы, вы готовы переходить к движению объекта и обработке клавиатуры

Что почитать дальше по Python

Если нужен общий маршрут по теме, откройте рубрику Python. Для соседних задач пригодятся эти разборы:

0 комментариев

Старые

Новые Популярные