Как настроить VS Code для Python

Что получится

Ниже — не скриншот, а наглядная модель результата. Нажмите кнопку: редактор покажет, как меняется код после форматирования и проверки.

def greet(name):
 return f"DeeNet приветствует тебя, {name}"
print(greet("друг"))

Зачем это нужно: форматтер убирает споры о стиле, а линтер подчёркивает проблему ещё до запуска программы.

База: Python, папка проекта и окружение

1. Установите Python. В VS Code откройте Extensions или нажмите Ctrl + Shift + X. Найдите расширение Python от Microsoft и установите его.
2. Откройте папку проекта. Нажмите File → Open Folder. Не работайте с отдельным файлом: тогда VS Code сможет видеть виртуальное окружение и настройки проекта.
3. Создайте окружение. Откройте терминал Ctrl + ` и выполните команду ниже.
4. Выберите интерпретатор. Нажмите Ctrl + Shift + P, введите Python: Select Interpreter и выберите вариант из папки .venv.

python -m venv .venv

После создания окружения откройте новый терминал. Если в начале строки появилось (.venv), VS Code использует окружение проекта. Именно в него будут устанавливаться библиотеки, а не в Python всей системы.

Расширения: ставим минимум, а не всё подряд

Откройте Extensions через Ctrl + Shift + X. Установите только эти расширения:

• Python от Microsoft — запуск, выбор интерпретатора, отладка и тесты.
• Pylance от Microsoft — подсказки типов, переход к определениям и поиск ошибок.
• Ruff от Astral Software — быстрая проверка кода и автоматические исправления.

Не нужно одновременно ставить несколько форматтеров и линтеров. Выберите один набор: в этом гайде — Ruff. Так подсказки не будут дублироваться и спорить между собой.

Устанавливаем инструменты в окружение проекта

В терминале с активным (.venv) установите Ruff и pytest. Это инструменты именно для разработки, а не часть Python «из коробки».

python -m pip install ruff pytest
python -m pip freeze > requirements.txt

Файл requirements.txt сохранит список библиотек. На другом компьютере проект можно восстановить одной командой: python -m pip install -r requirements.txt.

Готовые настройки проекта

Создайте файл .vscode/settings.json внутри папки проекта и вставьте этот блок. Он включает форматирование при сохранении и проверку кода через Ruff.

{
  "editor.formatOnSave": true,
  "editor.codeActionsOnSave": {
    "source.fixAll.ruff": "explicit"
  },
  "python.analysis.typeCheckingMode": "basic",
  "python.terminal.activateEnvironment": true,
  "files.trimTrailingWhitespace": true
}

Для работы Ruff установите расширение Ruff от Astral Software. Оно быстро находит лишние импорты, неиспользуемые переменные и типичные ошибки.

Запуск и отладка: ищем причину, а не гадаем

1. Поставьте точку останова: кликните слева от номера строки. Появится красный круг.
2. Откройте вкладку Run and Debug или нажмите Ctrl + Shift + D.
3. Нажмите Run and Debug и выберите Python File.
4. Когда выполнение остановится, посмотрите значения переменных слева и пройдите код по строкам клавишей F10.

Для первого скрипта не нужен сложный launch.json: VS Code умеет запускать текущий Python-файл с выбранным интерпретатором. Конфигурации понадобятся позже — для Flask, Django, FastAPI или нескольких точек запуска.

Тесты: первая проверка без ручного запуска

Создайте рядом с main.py файл test_main.py. VS Code покажет тесты во вкладке Testing, когда обнаружит pytest.

from main import greet


def test_greet():
    assert greet("друг") == "DeeNet приветствует тебя, друг"

Функция greet возвращает строку через return, а print выводит её в терминал. Это хороший первый пример разницы между «вернуть значение» и «показать результат».

Git: сохраняем историю проекта с первого дня

Установите Git отдельно, затем в VS Code откройте Source Control клавишами Ctrl + Shift + G и нажмите Initialize Repository. После каждого заметного шага: посмотрите изменения, добавьте их в Stage, напишите понятное сообщение и сделайте Commit.

.venv/
__pycache__/
.pytest_cache/
.env

Виртуальное окружение, кэш и пароли не отправляют в Git. В репозиторий попадают код, requirements.txt, документация и безопасные настройки проекта.

Как проверить, что всё готово

1. В статус-баре VS Code выбран интерпретатор из .venv.
2. Терминал начинается с (.venv).
3. При сохранении Ruff форматирует файл и показывает проблемы.
4. Кнопка запуска выводит DeeNet приветствует тебя, друг.
5. Вкладка Testing находит тест, а Source Control видит изменения проекта.