Перейти до змісту

PyCharm: повний гайд для курсу

PyCharm — середовище розробки (IDE) для Python від компанії JetBrains. В одному вікні — редактор з підказками й перевіркою коду, запуск програм, дебагер, термінал, керування пакетами, Git і ноутбуки Jupyter. IDE — це інструмент, а не мова: той самий код працює і в PyCharm, і у VS Code, і в терміналі.

Яку версію брати

З версії 2025.1 PyCharm Community і PyCharm Professional об'єднано в один продукт — PyCharm:

  • основні можливості безкоштовні: редактор, запуск, дебагер, venv, пакети, Git, ноутбуки Jupyter. Для всього курсу цього досить;
  • Pro-підписка додає веб-фреймворки (Django, Flask, FastAPI), роботу з базами даних, віддалені інтерпретатори (SSH, Docker, WSL), розширені можливості ноутбуків;
  • після встановлення діє безкоштовний місячний пробний період Pro; після нього PyCharm лишається працювати в безкоштовному режимі;
  • окремої Community Edition більше немає: 2025.2 — останній окремий реліз, далі — лише об'єднаний PyCharm.

Pro безкоштовно для студентів

JetBrains дає безкоштовні освітні ліцензії студентам і викладачам акредитованих навчальних програм тривалістю понад рік: підтвердження через університетську пошту, картку ISIC або GitHub Student Developer Pack. Подати заявку — на сторінці Free JetBrains Student Pack. Для нашого курсу Pro не обов'язковий: до модуля 4 (веб) вистачає безкоштовних можливостей.

Встановлення

Спосіб 1 — JetBrains Toolbox App (рекомендований JetBrains). Це невелика програма, яка встановлює й оновлює IDE JetBrains:

  • Windows — завантаж .exe зі сторінки Toolbox App і пройди майстер встановлення;
  • macOS — завантаж .dmg (окремо для Intel і Apple Silicon) і перетягни Toolbox у Applications;
  • Linux — завантаж архів .tar.gz і розпакуй.

У Toolbox знайди PyCharm → Install.

Спосіб 2 — окремий інсталятор зі сторінки завантаження PyCharm.

Сам Python PyCharm не встановлює за тебе автоматично — встанови Python 3.10+ заздалегідь (див. урок 2 і Налаштування середовища).

Перший проєкт із віртуальним середовищем

  1. Запусти PyCharm → New Project.
  2. Вкажи Location — папку проєкту (наприклад, lesson_03).
  3. У блоці інтерпретатора вибери створення нового virtualenv (venv) і базовий Python 3.10+. PyCharm створить папку .venv усередині проєкту.
  4. Create.

Щоб працювати з клонованим репозиторієм курсу: Open → вибери папку PY-Course-Victor-Nikoriak-22-09-2026 → далі налаштуй інтерпретатор (наступний розділ).

Інтерпретатор: який Python виконує код

Інтерпретатор проєкту — це Python, яким PyCharm запускає код, перевіряє імпорти й у який ставить пакети. Для роботи потрібен хоча б один інтерпретатор: системний Python або віртуальне середовище (venv) — базовий інтерпретатор плюс свої встановлені пакети. PyCharm уміє створювати середовища Virtualenv, pipenv, Poetry, uv, Hatch і conda; для курсу беремо звичайний Virtualenv (venv).

Перед налаштуванням Python має бути встановлений: PyCharm лише вказує шлях до нього.

Швидко: перемикач у рядку стану

Поточний інтерпретатор видно в правому нижньому куті вікна (рядок стану), наприклад Python 3.12 (lesson_03). Клік по ньому відкриває меню Python Interpreter:

  • список доступних інтерпретаторів — клік перемикає проєкт на вибраний;
  • Add New Interpreter — створити новий (наприклад, venv);
  • Interpreter Settings… — відкрити налаштування інтерпретатора;
  • Manage Packages… — перейти до пакетів поточного інтерпретатора.

У налаштуваннях

ОС Шлях Клавіші
Windows / Linux File → Settings → Python → Interpreter Ctrl+Alt+S, далі Python → Interpreter
macOS PyCharm → Settings → Python → Interpreter ⌘, (Command-кома)
  • Випадний список угорі — вибрати інтерпретатор; якщо потрібного немає — Show All (там же можна перейменувати чи видалити інтерпретатор кнопкою Remove Interpreter).
  • Нижче — таблиця пакетів вибраного інтерпретатора: встановлена версія, остання доступна, стрілка біля пакета, для якого є оновлення.

Додати venv

Add Interpreter (поруч зі списком у налаштуваннях) або Add New Interpreter у перемикачі → Add Local Interpreter:

  • новий venv: тип Virtualenv → нове середовище, базовий Python 3.10+. Галочку «Inherit packages from base interpreter» не став — тоді venv чистий, як і має бути;
  • наявний venv (наприклад, створений у терміналі командою python -m venv .venv): вибери наявне середовище й вкажи шлях до Python:
    • Windows: .venv\Scripts\python.exe
    • macOS / Linux: .venv/bin/python

Інтерпретатор за замовчуванням для нових проєктів

File → New Projects Setup → Settings for New Projects → Python Interpreter — PyCharm автоматично призначатиме його проєктам, які ще не мають своїх налаштувань (папки .idea).

Віддалені інтерпретатори (SSH, Docker, Docker Compose, WSL) — функція Pro; для курсу вони не потрібні.

Запуск коду

Дія Windows / Linux macOS
запустити поточний файл (з контекстного меню чи клавішами) правий клік у редакторі → Run '<файл>', або Ctrl+Shift+F10 ⌃⇧R (Control+Shift+R)
запустити конфігурацію, вибрану у віджеті Run угорі кнопка ▶ або Shift+F10 ▶ або ⌃R (Control+R)
вибрати, яку конфігурацію запустити Alt+Shift+F10 ⌃⌥R (Control+Option+R)
запустити з дебагером кнопка з жуком або Shift+F9 кнопка з жуком
відкрити вікно Run / Debug Alt+4 / Alt+5 ⌘4 / ⌘5
інтерактивний Python Tools → Python Console або кнопка Python Console внизу те саме

Результат з'являється у вікні Run внизу. Помилки (traceback) там клікабельні: клік по File "...", line 12 переносить у потрібний рядок.

Конфігурації запуску (Run/Debug Configurations)

Конфігурація — іменований набір налаштувань: що запускати, яким інтерпретатором, з якими параметрами й змінними оточення. Список конфігурацій — у віджеті Run угорі поруч із кнопкою ▶.

  • Тимчасова конфігурація створюється сама щоразу, коли запускаєш файл через Run '<файл>'. Її іконка напівпрозора; PyCharm тримає до 5 тимчасових конфігурацій і видаляє старіші.
  • Постійна — збережена: у віджеті Run вибери тимчасову → Save Configuration, або створи нову з шаблону. Постійні лишаються в проєкті, доки їх не видалиш. Червоний хрестик на іконці — помилка в налаштуваннях.

Створити чи змінити: Run → Edit Configurations… (або віджет Run → Edit Configurations) → + → шаблон Python. Основні поля:

Поле Що задає
Name назва в списку конфігурацій
Python Interpreter яким Python запускати (можна не той, що в проєкті)
Script path / Module name файл .py або ім'я модуля (як python -m модуль)
Parameters аргументи командного рядка через пробіл; аргумент із пробілами — у лапках
Working directory робоча папка програми — від неї рахуються відносні шляхи до файлів (урок 15). Для запуску з контекстного меню — папка, де лежить скрипт; вона може не збігатися з папкою проєкту
Environment variables змінні оточення; за замовчуванням там PYTHONUNBUFFERED=1 (вивід одразу з'являється у вікні Run)
Paths to ".env" files файли .env зі змінними оточення (ключі API не пишемо в код — їх кладуть у .env)

Приховані параметри відкриває посилання Modify options. Кнопка OK зберігає конфігурацію, Run — зберігає й одразу запускає.

Чому «файл не знайдено», хоча він поруч

Якщо програма читає data.csv, а PyCharm каже FileNotFoundError, найчастіше винна Working directory: відносний шлях рахується від неї, а не від місця, де лежить скрипт. Перевір це поле в конфігурації.

Before launch: що зробити перед запуском

У конфігурації є блок Before launch — список задач, які PyCharm виконає перед запуском, по черзі згори донизу. Додати задачу — кнопка + (Alt+Insert / ⌘N), прибрати — − (Alt+Delete / ⌘⌫), змінити порядок — стрілками.

Задача Навіщо
Run Another Configuration спершу виконати іншу конфігурацію й дочекатися її кінця. Наприклад, скрипт, що готує дані, перед основною програмою
Run External tool запустити зовнішню програму (скажімо, форматувальник чи скрипт оболонки)
Launch Web Browser відкрити браузер за адресою — знадобиться для веб-застосунків у модулі 4

Решта задач у списку (Grunt, gulp, npm, TypeScript, File Watchers, Data Source) — для веб- і фронтенд-розробки; у курсі Python вони не потрібні.

Галочки під списком:

  • Show this page — показувати вікно налаштувань конфігурації перед кожним запуском (зручно, коли щоразу змінюєш параметри);
  • Activate tool window (увімкнено за замовчуванням) — відкривати вікно Run чи Debug під час запуску; якщо вимкнути, відкрити вручну можна Alt+4 / Alt+5 (macOS ⌘4 / ⌘5);
  • Focus tool window — одразу переводити курсор у вікно Run/Debug (корисно, коли програма чекає на input()).

Щоб поділитися конфігурацією з командою, увімкни в ній Store as project file — налаштування збережуться у файл у папці .idea проєкту, і його можна закомітити.

Дебагер крок за кроком

Дебагер (debugger) дозволяє зупинити програму на потрібному рядку й подивитися значення всіх змінних. Це найкращий спосіб зрозуміти, чому код робить не те, що ти очікуєш.

  1. Точка зупинки (breakpoint): клікни на сірому полі зліва від номера рядка — з'явиться червона крапка. Або курсор у рядок і Ctrl+F8 (macOS ⌘F8).
  2. Запусти з дебагером: Shift+F9 або правий клік → Debug '<файл>'.
  3. Програма зупиниться перед виконанням рядка з крапкою. Внизу відкриється вікно Debug: зліва — стек викликів (які функції зараз виконуються), справа — Variables, усі змінні та їхні значення.
  4. Далі керуй виконанням:
Клавіша Команда Що робить
F8 Step Over виконати поточний рядок і перейти до наступного, не заходячи всередину функцій
F7 Step Into зайти всередину функції, що викликається в рядку
Shift+F7 Smart Step Into якщо в рядку кілька викликів — вибрати, в який зайти
Alt+Shift+F7 Step Into My Code заходити лише у свій код, не в бібліотеки
F9 Resume виконувати далі до наступної точки зупинки

Порада: крок за кроком (F8) пройди цикл з уроку 6 і стеж у Variables, як змінюються лічильник і список — це дає інтуїцію, якої не дасть жоден print.

Вбудований термінал

Alt+F12 (або кнопка Terminal внизу) відкриває термінал у папці проєкту. Якщо інтерпретатор проєкту — venv і в Settings → Tools → Terminal увімкнено Activate virtualenv, venv у терміналі активується автоматично: на початку рядка буде (.venv). Тут зручно запускати git, pip, pytest, jupyter lab.

Встановлення пакетів

Вікно Python Packages: кнопка Python Packages зліва або меню View → Tool Windows → Python Packages.

  1. Почни вводити назву пакета в пошук.
  2. Вибери пакет → Install (остання версія) або вибери версію зі списку.

Пакет ставиться в поточний інтерпретатор проєкту; за замовчуванням PyCharm керує пакетами через pip. Ті самі пакети з версіями й кнопкою оновлення видно в налаштуваннях Python → Interpreter (або Manage Packages… у перемикачі інтерпретатора). Альтернатива — вбудований термінал з активованим venv: pip install назва або pip install -r requirements.txt.

Git у PyCharm

PyCharm уміє все, що потрібно для здачі домашніх робіт, без командного рядка:

Дія Як
створити / перемкнути гілку клік по назві гілки у верхній панелі (віджет Git) → New Branch…, назва homework-03, галочка Checkout branch
коміт Ctrl+K (macOS ⌘K) → відміть файли → повідомлення коміту → Commit
push Ctrl+Shift+K (macOS ⌘⇧K)
коміт і одразу push Ctrl+Alt+K / кнопка Commit and Push… у вікні коміту
історія, гілки вікно Git (Alt+9) → вкладка Log
усі Git-дії Alt+` (VCS Operations Popup) або меню Git

Pull Request на GitHub створюй як завжди — на сайті GitHub після push.

Ноутбуки Jupyter у PyCharm

Підтримка Jupyter — у безкоштовній частині PyCharm: відкрий .ipynb у проєкті, і PyCharm покаже клітинки з кнопками запуску, результати й підказки коду. Ноутбук виконується на інтерпретаторі проєкту, тому бібліотеки для ноутбука ставляться туди ж (вікно Python Packages або %pip install у клітинці). Розширені можливості (віддалені ноутбуки, SQL-клітинки, інтерактивні таблиці) — у Pro.

Корисні налаштування

  • Шрифт і розмір: Settings → Editor → Font.
  • PEP 8: PyCharm перевіряє стиль «з коробки» — жовте підкреслення й підказки справа. Наведи курсор на підкреслене, щоб прочитати пояснення, і натисни Alt+Enter (macOS ⌥↩) — PyCharm запропонує виправлення.
  • Автоформатування: Ctrl+Alt+L (macOS ⌘⌥L) — Reformat Code, розставляє відступи й пробіли за PEP 8.
  • Мова інтерфейсу, тема — Settings → Appearance & Behavior.

Гарячі клавіші, які варто вивчити першими

Дія Windows / Linux macOS
знайти будь-що (файл, клас, налаштування) Shift двічі Shift двічі
знайти дію / команду меню Ctrl+Shift+A ⌘⇧A
переформатувати код Ctrl+Alt+L ⌘⌥L
закоментувати рядок Ctrl+/ ⌘/
дублювати рядок Ctrl+D ⌘D
запустити вибрану конфігурацію Shift+F10 ⌃R
запустити поточний файл Ctrl+Shift+F10 ⌃⇧R
дебаг Shift+F9 див. Keymap
термінал Alt+F12 див. Keymap
точка зупинки Ctrl+F8 ⌘F8

Якщо сумніваєшся — Find Action (Ctrl+Shift+A) і введи назву дії англійською: PyCharm покаже і команду, і її гарячу клавішу. Повна шпаргалка для твоєї ОС — Help → Keyboard Shortcuts PDF.

Плагіни

Settings → Plugins → Marketplace — пошук і встановлення, вкладка Installed — керування встановленими. Основне для курсу (Python, Git, Markdown, Jupyter) уже вбудоване. Став плагіни свідомо: кожен плагін уповільнює запуск IDE, а плагіни від невідомих авторів отримують доступ до твого коду.

Джерела