Для запуска Python в VS Code нужны три отдельные части: сам редактор, расширение Python от Microsoft и установленный интерпретатор Python 3. После установки откройте папку проекта, выберите команду Python: Select Interpreter, создайте файл hello.py и нажмите Run Python File. Если в терминале появился ожидаемый текст, базовая настройка закончена.
Самая частая путаница начинается с расширения. Оно добавляет подсветку, подсказки, запуск и отладку, но не содержит Python внутри. Команду выполняет отдельный интерпретатор, а VS Code лишь выбирает его и передаёт ему путь к файлу.
VS Code открывает папку, файлы, терминал и команды.
Python от Microsoft связывает редактор с инструментами языка.
Python 3 действительно читает и выполняет файл .py.
Установка VS Code, Python и расширения
| Компонент | Как проверить | Если отсутствует |
|---|---|---|
| VS Code | Редактор открывается и показывает Welcome | Скачать установщик с официального сайта VS Code |
| Python 3 | py --version в Windows или python3 --version в macOS и Linux | Установить актуальный Python 3 отдельно |
| Расширение Python | В Extensions есть Python от Microsoft со статусом Installed | Найти Python и нажать Install |
| Папка проекта | В Explorer видна выбранная папка | File, затем Open Folder |
- Закройте терминалы, которые были открыты до установки Python.
- Перезапустите VS Code, чтобы он перечитал доступные программы.
- Откройте Terminal, затем New Terminal.
- В Windows выполните
py --version, в macOS или Linux выполнитеpython3 --version. - Убедитесь, что команда печатает Python 3 и номер версии, а не сообщение «команда не найдена».
Если отсутствует хотя бы один компонент, кнопка запуска либо не появится, либо не найдёт программу Python.
python-start и откройте её через Open Folder до создания файла.Как выбрать правильный интерпретатор
Нажмите Ctrl+Shift+P в Windows или Linux, Cmd+Shift+P в macOS. Введите Python: Select Interpreter и выберите Python 3 из списка. Текущий выбор отображается в строке состояния и используется для запуска, отладки и подсказок редактора.
| В списке | Когда выбирать | Что проверить |
|---|---|---|
.venv внутри проекта | Для текущего учебного проекта | Путь начинается с открытой папки |
| Global или System Python | Для первого файла без библиотек | Это Python 3, а не старый или удалённый путь |
| Conda | Проект уже создан в Conda | Название нужного окружения совпадает |
| Recommended | VS Code нашёл локальную среду проекта | После выбора версия появилась в строке состояния |
После выбора откройте новый терминал и выполните python -c "import sys; print(sys.executable)". Команда напечатает точный путь к программе, которая сейчас запускает код. На macOS и Linux вне активированной среды вместо python может потребоваться python3.
Название версии помогает, но точный путь надёжнее: он показывает, какой Python получит ваши библиотеки и запустит файл.
В строке состояния виден Python 3, команда sys.executable указывает на существующий файл, а новый терминал активирует выбранную среду или запускает тот же путь. Если пути разные, закройте терминал и создайте новый после выбора интерпретатора.
Создаём и запускаем первый файл Python
- В Explorer нажмите New File и назовите файл
hello.py. - Вставьте код ниже и сохраните файл через
Ctrl+SилиCmd+S. - Нажмите треугольник Run Python File в правом верхнем углу редактора.
- Посмотрите на команду, которую VS Code выполнил во встроенном терминале.
- Убедитесь, что последняя строка равна
Привет, Аня! Через год: 17.
name = 'Аня'
age = 16
next_age = age + 1
print(f'Привет, {name}! Через год: {next_age}')Кнопка запуска сохраняет файл, открывает терминал, активирует выбранную среду и выполняет команду с полным путём к hello.py. В Windows это обычно выглядит как python hello.py, в macOS и Linux может использоваться python3 hello.py.
Окно Output предназначено для журналов расширений, а обычный вывод print ищите во вкладке Terminal.
Run Python File in Terminal от расширения Python и сверяйте путь в терминале.Виртуальная среда и установка библиотек
Виртуальная среда хранит библиотеки одного проекта отдельно от остальных. Для файла с одним print она не обязательна, но полезна сразу после появления первого внешнего пакета. Стандартное имя .venv VS Code обнаруживает внутри рабочей папки автоматически.
# Windows
py -m venv .venv
# macOS или Linux
python3 -m venv .venv
# После выбора .venv через Python: Select Interpreter
python -m pip install requests
python -c "import requests; print(requests.__version__)"Команда -m venv .venv создаёт отдельный Python для папки.
Select Interpreter связывает проект с новой средой.
python -m pip ставит пакет именно в выбранный Python.
Команда явно запускает модуль pip тем интерпретатором, который стоит перед -m. Это уменьшает риск установить пакет в один Python, а запустить файл другим.
.venv/ в .gitignore, а список зависимостей храните в requirements.txt или pyproject.toml.Что делать, если Python в VS Code не запускается
Откройте файл с расширением .py, установите расширение Python от Microsoft и дождитесь его активации.
Интерпретатор не установлен или старый терминал не видит новый путь. Установите Python, перезапустите VS Code и снова выполните Select Interpreter.
Пакет попал в другую среду. Сравните sys.executable и устанавливайте через python -m pip в новом терминале.
Сохраните документ и посмотрите путь в команде терминала. Одинаковые имена hello.py в разных папках легко перепутать.
Вы находитесь в интерактивной оболочке Python. Выполните exit(), затем запустите файл через кнопку редактора.
- Проверьте версию:
python --versionилиpython3 --version. - Проверьте путь:
python -c "import sys; print(sys.executable)". - Проверьте текущую папку командой
pwdв macOS и Linux илиGet-Locationв PowerShell. - Запустите файл вручную:
python hello.py. - Если ручной запуск работает, повторно выберите интерпретатор и используйте Run Python File.
Если терминал не знает pip, не скачивайте случайный установщик. Сначала проверьте выбранный Python и используйте отдельную инструкцию pip не является командой. Ошибка импорта уже установленной библиотеки разобрана в статье про ModuleNotFoundError.
Расширение Python устанавливает сам Python?
Нет. Интерпретатор ставится отдельно, а расширение добавляет поддержку языка, запуск и отладку в VS Code.
Как понять, какой Python выбран?
Посмотрите строку состояния и выполните команду с sys.executable во встроенном терминале.
Нужна ли виртуальная среда для первого файла?
Для программы без внешних пакетов нет. Создайте её, когда проекту понадобятся отдельные зависимости.
Где искать результат print?
Во вкладке Terminal. Кнопка Run Python File запускает файл во встроенном терминале.
Почему библиотека установлена, но импорт не работает?
Чаще всего pip и запуск относятся к разным интерпретаторам. Выберите среду и ставьте пакет через python -m pip.
Пройдите задания в курсе Python и держите каждую тему в отдельной папке с собственной .venv, когда она понадобится. Полный маршрут от установки до терминала собран в статье первый Python-скрипт.
После успешного hello.py добавьте ввод через input(), условие и функцию. В Кодике тот же короткий код можно запустить без локальной настройки, а затем перенести рабочий вариант в VS Code.