Python

Как настроить VS Code для Python: расширение, интерпретатор, терминал и запуск

VS Code сам по себе не является Python. Это редактор, в котором удобно писать код. Чтобы Python-код запускался, на компьютере должен быть установлен интерпретатор Python, а в VS Code нужно выбрать правильное расширение и правильный интерпретатор

Хорошая настройка выглядит так: вы открываете папку проекта, создаете файл .py, VS Code видит Python, терминал запускает тот же интерпретатор, а библиотеки ставятся в то же окружение, из которого потом запускается программа

Что нужно заранее

Перед настройкой VS Code проверьте, что Python установлен

На Windows

py --version

На macOS и Linux

python3 --version

Если терминал показывает версию Python, можно переходить к VS Code. Если нет, сначала установите Python с официального сайта или через пакетный менеджер вашей системы

Установите расширение Python

Откройте VS Code, перейдите в Extensions и найдите расширение Python от Microsoft. Установите его. Обычно вместе с ним подтягиваются инструменты для подсветки, запуска, подсказок и выбора интерпретатора

После установки откройте папку проекта, а не отдельный файл. Это важно: VS Code лучше понимает окружение, настройки и терминал, когда открыт именно каталог проекта

Создайте первый файл

Создайте папку python_vscode_lesson, откройте ее в VS Code и создайте файл hello.py

print("VS Code запускает Python")
print("Первый файл работает")

Сохраните файл. Без сохранения можно легко запустить старую версию кода и решить, что VS Code «не видит» изменения

Выберите интерпретатор Python

Откройте Command Palette сочетанием Ctrl + Shift + P на Windows и Linux или Cmd + Shift + P на macOS. Найдите команду Python: Select Interpreter

Выберите установленный Python. Если у проекта есть виртуальное окружение .venv, выбирайте интерпретатор внутри него. Обычно он выглядит как путь к .venv

Если VS Code не предлагает Python, значит редактор не нашел интерпретатор. Проверьте установку Python в обычном терминале и перезапустите VS Code

Запустите файл через терминал

Откройте встроенный терминал: Terminal → New Terminal. Он должен открыться в папке проекта. Проверьте, что рядом есть файл hello.py

На Windows выполните

py hello.py

На macOS и Linux выполните

python3 hello.py

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

python hello.py

Вы должны увидеть вывод

VS Code запускает Python
Первый файл работает

Как создать виртуальное окружение в VS Code

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

python -m venv .venv

Если команда python не работает, используйте py на Windows или python3 на macOS и Linux

Активация на Windows

.venv\Scripts\activate

Активация на macOS и Linux

source .venv/bin/activate

После этого снова откройте Python: Select Interpreter и выберите Python из .venv. Это позволит ставить библиотеки внутрь проекта

Как установить библиотеку в выбранное окружение

Откройте терминал VS Code и выполните

python -m pip install requests

Потом проверьте импорт в файле check_requests.py

import requests

print("requests установлен")
print(requests.__version__)

Если появляется ModuleNotFoundError, почти всегда библиотека установлена в один Python, а VS Code запускает другой. Снова проверьте выбранный интерпретатор

Что делать, если кнопка Run запускает не тот Python

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

Если кнопка Run ведет себя странно, проверьте три вещи: выбранный интерпретатор, открытую папку проекта и активное виртуальное окружение. В нижней строке VS Code обычно видно, какой Python выбран

Как настроить форматирование

Для первых уроков форматирование не обязательно, но оно помогает держать код ровным. В Python часто используют Ruff или Black. Начать можно без них, а потом установить форматтер, когда базовый запуск уже работает

Не ставьте сразу десять расширений. Сначала добейтесь простой цепочки: файл сохранен, интерпретатор выбран, команда запуска работает, библиотека ставится и импортируется

Частые ошибки

Первая ошибка — установить VS Code, но не установить Python. Редактор не заменяет интерпретатор

Вторая ошибка — открыть отдельный файл, а не папку проекта. Из-за этого терминал может оказаться не там, где лежит код

Третья ошибка — поставить библиотеку через один Python, а запускать код через другой. Используйте python -m pip install ... и проверяйте выбранный интерпретатор

Четвертая ошибка — забыть сохранить файл перед запуском. Если вывод не меняется, нажмите Save и запустите снова

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

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

name = "Динар"
language = "Python"

print("Имя:", name)
print("Язык:", language)
print("VS Code настроен")

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

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

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

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

Старые

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