Перший проект

8.1 Розбір IDE

Отже, ми створили новий проект. Давайте розберемося, що ми тут бачимо.

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

Тут відображається вміст папки нашого проекту – pythonProject.

2. Поточний відкритий файл:

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

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

Корисні кнопки справа зверху:

• «Зелений трикутник» — кнопка запуску проекту.
• «Жук» — кнопка запуску режиму відладки.
• «Лупа» — пошук по проекту.
• «Шестерня» — налаштування.

4. Зліва ви бачите бокове меню:

Тут є кілька корисних кнопок, нас, зокрема, буде цікавити кнопка Terminal.

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

Зліва в статус-барі відображається шлях поточного відкритого файлу. Справа — його кодування: CRLF, UTF-8.

А зовсім справа відображається поточна версія Пітона – Python 3.12.x, на якій буде виконуватися наш проект. Буває корисно сюди глянути, якщо у вас на комп'ютері встановлено кілька різних версій Пітона, і є проекти, що працюють на інших версіях.

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, значить ми з вами на вірному шляху.