Первый проект

8.1 Разбор устройства IDE

Итак, мы создали новый проект. Давайте разберемся, что мы тут видим.

1. Дерево папок и файлов проекта:

Тут отображается содержимое папки нашего проекта — pythonProject.

2. Текущий открытый файл:

Это — просто содержимое файла main.py, синтаксис кода подсвечен.

3. Сверху — основное меню:

Полезные кнопки справа сверху:

• «Зеленый треугольник» — кнопка запуска проекта.
• «Жук» — кнопка запуска режима отладки.
• «Лупа» — поиск по проекту.
• «Шестеренка» — настройки.

4. Слева вы видите боковое меню:

Тут есть несколько полезных кнопок, нас, в частности, будет интересовать кнопка Terminal.

5. Статус-бар:

Слева в статус-баре отображается путь текущего открытого файла. Справа — его кодировка: CRLF, UTF-8.

А совсем справа отображается текущая версия Python — Python 3.12.x, на которой будет выполняться наш проект. Бывает полезно сюда глянуть, если у вас на компьютере установлено несколько разных версий Python, и есть проекты, которые работают на других версиях.

8.2 Разбор проекта

Обычный проект состоит из файлов, которые отображаются в левой панели. Эти файлы можно условно разделить на 4 части.

Файлы с кодом на языке Python. Такие файлы имеют расширение .py и PyCharm отмечает их сине-желтой иконкой. В нашем проекте сейчас только один такой файл — main.py

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

Виртуальное окружение Python. В папке с именем .venv (сокращение от Virtual Environment) содержатся файлы Python, а так же нескольких служебных утилит. Сюда же менеджер пакетов pip будет загружать сторонние библиотеки, которые вы захотите использовать.

Сторонние библиотеки (External libraries). Сейчас их в нашем проекте нет, но когда вы их скачаете, то PyCharm обязательно их тут отобразит.

8.3 Виртуальное окружение .venv

Давайте немного подробнее поговорим о виртуальном окружении. .venv — это модуль в Python, который предоставляет возможность создавать разные легкие и изолированные виртуальные среды для Python-проектов. Это инструмент, позволяющий управлять зависимостями проекта, изолируя их от системных библиотек. Представьте, что это изолированная комната для вашего проекта, где он может хранить свои личные игрушки и инструменты, не мешая остальным жильцам дома

Технически это работает просто: внутри папки проекта создается копия интерпретатора Python и отдельное место для библиотек. Это гарантирует, что если вы установите какую-то специфическую версию библиотеки для одного проекта, она не сломает другой, которому нужна более старая версия. Использование виртуального окружения — правило хорошего тона, которое спасает от бесконечных конфликтов версий.

Управление окружением в PyCharm

PyCharm обычно сам заботится об этом и создает всё автоматически. Но бывает так, что вы случайно удалили нужную папку или просто хотите начать всё с чистого листа. Уметь управлять этими настройками руками — полезный навык.

Создаем окружение

В правом нижнем углу отображается статус подключения языка Python. Если вы видите там надпись вроде Python 3.ХХ, значит, установка прошла успешно. Среда разработки видит интерпретатор и готова выполнять ваши команды.

Если же там написано No interpreter, нажмите на эту надпись.

1. В появившемся меню выбираем Add New Interpreter и затем Add Local Interpreter.
2. В настройках слева выбираем Environment. В центре убедитесь, что стоит галочка на Generate New.
3. Жмем OK. Редактор создаст новую папку .venv и сразу переключит проект на неё. Теперь у вас есть абсолютно чистая система без лишнего мусора.

Удаляем старое или лишнее

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

1. Снова кликаем на версию Python в правом нижнем углу и выбираем пункт Interpreter Settings.
2. Вверху ищем поле Python Interpreter. Раскрываем список и выбираем пункт Show All.
3. Вы увидите список всех окружений, о которых знает PyCharm. Выделите то, которое хотите убрать, и нажмите кнопку с минусом в меню над списком.
4. Важный момент, PyCharm просто «забудет» про это окружение и перестанет его использовать. Чтобы физически освободить место на диске, вам нужно зайти в папку проекта через обычный проводник и удалить папку .venv вручную.

Создание второго окружения

Ошибка: «Already contains Python»

Если вы зайдете в меню добавления интерпретатора и выберете Generate new, PyCharm может показать красное предупреждение и заблокировать кнопку OK. Это происходит потому, что редактор по привычке пытается создать новую среду в ту же самую папку .venv, которая уже занята вашим первым окружением. Два разных набора библиотек не могут жить в одной папке.

Как это исправить

Нужно просто дать новой «песочнице» уникальное имя. Вот как это сделать:

1. Откройте меню Add Local Interpreter, как мы делали раньше.
2. Выберите пункт Generate new.
3. Взгляните на поле Location. Скорее всего, путь там заканчивается на стандартное имя \.venv.
4. Поставьте курсор в конец строки и просто допишите туда любую цифру. Измените концовку пути на \.venv_2 и нажмите Enter.
5. Красная надпись тут же исчезнет. Жмите OK.

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

Как переключаться между окружениями

Умение жонглировать окружениями — важный навык. Но здесь есть подвох: PyCharm не всегда запоминает ваши старые окружения автоматически.

Часто бывает так, вы создали второе окружение, а первое пропало из меню, хотя папка .venv всё еще лежит в проекте. В этом случае нужно просто указать PyCharm, где искать старый Python. Пример для переключения с .venv_2 на .venv:

1. Нажмите на версию Python в углу и выберите Add New Interpreter -> Add Local Interpreter
2. В появившемся окне переключите точку на пункт Select Existing.
3. В поле Python Path нажмите на иконку папки справа.
4. Теперь вам нужно найти файл запуска Python в вашей старой папке (.venv). Пройдите по пути: Ваш_проект -> .venv -> Scripts (для Windows) или bin (для macOS/Linux).
5. Внутри этой папки выберите файл python и нажмите OK.

Теперь старое окружение снова появится в настройках и станет активным. Этот способ работает безотказно, даже если PyCharm «забыл» про ваши настройки.

8.4 Работа с терминалом

В PyCharm вы можете работать с командной строкой операционной системы напрямую. В Linux и MacOS командную строку принято называть Терминалом (Terminal), поэтому в PyCharm она тоже так называется. Хотя в принципе это не блажь PyCharm, а устоявшееся название среди программистов.

Чтобы открыть Terminal вам нужно нажать на кнопку терминал в боковом меню:

У вас должно появиться такое окно:

В этом окне вы можете писать команды вашей операционной системы. Нас же интересует одна из них.

Давайте узнаем текущую версию интерпретатора Python, который мы установили. Для этого нужно написать:

        python --version

Вот что у меня получилось:

Если вы тоже получили Python 3.12.x, значит мы с вами на верном пути.