Содержание
Как настроить среду разработки Python в Visual Studio Code
Черновик готовит редакция с помощью ИИ. За стандарт издания отвечает главный редактор — Валерий Курземнек.
Чтобы установить Python в Visual Studio Code, нужны три вещи: интерпретатор Python с официального сайта python.org, сам редактор VS Code и бесплатное расширение Python от Microsoft. После этого остаётся выбрать интерпретатор командой «Python: Select Interpreter» и запустить первый файл кнопкой Run. Ниже — каждый шаг подробно, с актуальной для 2026 года схемой установки: с версии Python 3.14 дистрибутив для Windows ставится через новый Python Install Manager, и большинство старых инструкций в этом месте уже расходятся с реальностью.
Что будет в статье:
- установка Python 3.14 через Python Install Manager — так, как это работает сейчас;
- установка VS Code и расширения Python;
- выбор интерпретатора и запуск первого файла;
- три способа запускать код и когда какой удобнее;
- виртуальное окружение, типичные ошибки и частые вопросы.
Почему именно VSCode?
VSCode — это редактор кода, который за счёт расширений дорастает до полноценной IDE: интегрированной среды разработки с отладчиком, терминалом, системой контроля версий и автодополнением. Ставите базовый редактор, добавляете нужные модули — получаете рабочее место под свои задачи, а не под чужие.
Для Python всё уже собрано. Официальное расширение Python от Microsoft — у него больше 231 миллиона установок в маркетплейсе VS Code — при установке само подтягивает три компаньона: Pylance для подсказок и автодополнения, Python Debugger для отладки и Python Environments для управления окружениями. Всё бесплатно.
Что даёт связка VS Code + расширение Python:
- вызов любой команды по имени через палитру команд (Ctrl + Shift + P);
- настраиваемые сочетания клавиш;
- линтинг — автоматическая проверка кода на ошибки и стиль;
- тестирование и отладка с точками останова;
- интеграция с Git;
- поддержка Jupyter-блокнотов — рабочего инструмента дата-сайентистов;
- продвинутое редактирование: мультикурсор, поиск по проекту, предпросмотр. Почти любая функция, которая придёт в голову, уже есть в библиотеке расширений.
Расширения закрывают и локальные задачи: есть даже плагин Koda с поддержкой русского языка — полезно, если английский интерфейс пока тормозит работу.
Настройка среды Visual Studio Code для Python
Порядок такой: сначала интерпретатор Python, потом редактор, потом расширение. Если поставить в обратном порядке, ничего не сломается — просто VS Code будет предлагать установить Python и придётся возвращаться к этому шагу.
1. Установка Python
Актуальная стабильная версия — Python 3.14.7, вышла 5 августа 2026 года. С версии 3.14 команда CPython рекомендует ставить Python на Windows через Python Install Manager — отдельный инструмент, который делает Python доступным как глобальную команду и сам обновляет версии. Привычный установщик-exe с галочкой «Add python.exe to PATH» объявлен устаревшим: для Python 3.16 его уже не будет.
Как поставить через Python Install Manager:
- скачайте Python Install Manager со страницы загрузок python.org/downloads или из Microsoft Store;
- запустите установку — менеджер поставит текущую версию Python;
- откройте терминал и наберите
python --version. Если в ответ пришло «Python 3.14.7» — всё готово. Работает и короткая командаpy; - при первом запуске менеджер может предложить добавить каталог в PATH — это опционально: команды
pythonиpyработают и без этого.
Подробный разбор установки и подводных камней Windows — в статье «Как работать в Python на Windows».
- ПОКАЖЕМ, КАК РАЗВЕРНУТЬ МОДЕЛЬ нейросети DEEPSEEK R1 ПРЯМО НА СВОЁМ КОМПЬЮТЕРЕ
- Где и как применять? Потестируем модель после установки на разных задачах
- Как дообучить модель под себя?
2. Установка VSCode
Здесь без сюрпризов: скачиваете редактор с официального сайта code.visualstudio.com и устанавливаете как любую другую программу. VS Code бесплатен для Windows, macOS и Linux.
3. Установка расширения Python
Откройте VS Code, нажмите Ctrl + Shift + X — откроется панель Extensions. В поиске наберите «Python», выберите расширение Python от издателя Microsoft и нажмите Install. Вместе с ним автоматически установятся Pylance, Python Debugger и Python Environments — отдельно их искать не нужно.
4. Выбор интерпретатора
Теперь надо сказать редактору, каким именно Python пользоваться. Нажмите Ctrl + Shift + P, в палитре команд наберите «Python: Select Interpreter» и выберите установленную версию — VS Code пометит подходящую строчкой «Recommended». Выбранная версия появится в строке состояния внизу окна.
Этот шаг можно и пропустить: при первом запуске .py-файла редактор сам попросит выбрать интерпретатор. Но лучше знать, где эта команда живёт — к ней вы будете возвращаться каждый раз, когда проектов и версий Python станет больше одного.
5. Первый файл и проверка среды
Осталось проверить, что всё работает. Для этого напишем мини-программу.
Чтобы создать новый файл, нажмите Ctrl + N или выберите File > New Text File. Кликните на «Select a language» и найдите в выпадающем списке «Python». После этого напишите код:
print(‘Hello world’)
Кстати, традицию писать в качестве тестового сообщения «Hello, world!» (или «Привет, мир!») закрепил учебник по программированию 1978 года «The C Programming Language». С тех пор так и повелось.
Сохраните файл сочетанием Ctrl + S. В меню сохранения выберите название и обязательно добавьте в конце расширение «.py», например «test.py».
Если интерпретатор ещё не выбран, внизу появится выделенная жёлтым кнопка «Select Interpreter». При нажатии откроется список — выберите вариант со строчкой «Recommended», как в шаге 4.
Теперь дело за малым — кликнуть на кнопку «Run» и запустить код. Результат появится в терминале.
Поздравляем с выполнением важной части работы: первой написанной на Python строчкой кода.
Как запустить код Python в VS Code: три способа
Кнопка Run — не единственный вариант. По документации VS Code запускать Python-файл можно тремя путями, и у каждого своя ситуация.
| Способ | Как | Когда удобен |
|---|---|---|
| Кнопка Run Python File | Стрелка в правом верхнем углу редактора | Быстрая проверка скрипта — редактор сам выполнит команду запуска в терминале |
| Терминал вручную | Открыть терминал и набрать python test.py |
Когда нужны аргументы командной строки или запуск конкретного файла из нескольких |
| Отладчик | Клавиша F5, точки останова — F9 или клик слева от номера строки | Код падает или ведёт себя странно — можно пройти его пошагово и посмотреть значения переменных |
Мини-вывод: для первых программ хватит кнопки Run, но F5 стоит попробовать уже на первой ошибке — отладчик экономит часы, которые новички тратят на расстановку print() по всему коду.
Виртуальное окружение: зачем и как
Виртуальное окружение — это изолированная копия Python внутри папки проекта. Библиотеки, которые вы ставите через pip, попадают только в неё и не засоряют систему. Два проекта с разными версиями одной библиотеки перестают конфликтовать.
В VS Code окружение создаётся одной командой:
- нажмите Ctrl + Shift + P и наберите «Python: Create Environment»;
- выберите тип окружения — Venv (стандартный вариант) или Conda;
- укажите интерпретатор, на базе которого создать окружение;
- в папке проекта появится каталог .venv, и VS Code сам переключит проект на него.
Для первых учебных скриптов окружение не обязательно. Оно становится нужным с первой внешней библиотекой — когда появляется pip install, появляется и повод изолировать проект.
Типичные ошибки при настройке Python в VS Code
«python не является внутренней или внешней командой» — терминал не находит Python. Чаще всего это значит, что Python ставили по старой инструкции и не добавили в PATH. С Python Install Manager проблема уходит: он делает команду python глобальной сам. Если ошибка осталась — закройте терминал и откройте заново: уже открытые окна не видят свежие изменения.
VS Code не предлагает интерпретатор. Расширение Python установлено, а списка версий нет. Проверьте в терминале python --version: если команда работает, а VS Code не видит — перезапустите редактор, он сканирует систему при старте.
Скрипты падают на кириллице в пути. Если системное имя пользователя написано кириллицей, часть инструментов Python спотыкается о такие пути. Радикальное решение — сменить имя пользователя на латиницу; обходное — держать проекты в папке с латинским путём, например C:\dev\project.
Код запускается не тем Python. Стоит несколько версий, и библиотека «то есть, то нет». Смотрите на строку состояния внизу окна: там показана активная версия. Переключение — та же команда «Python: Select Interpreter».
Частые вопросы
Нужно ли устанавливать Python отдельно, если уже есть VS Code?
Да. VS Code — редактор, интерпретатор Python в него не входит. Скачайте Python с официального сайта python.org, затем поставьте расширение Python в VS Code и выберите интерпретатор командой «Python: Select Interpreter».
Как запустить код Python в VS Code?
Три способа: кнопка Run Python File в правом верхнем углу редактора, команда python имя_файла.py в терминале или клавиша F5 для запуска с отладчиком. Результат работы программы появится во встроенном терминале.
Что делать, если VS Code не видит Python?
Нажмите Ctrl + Shift + P, выберите «Python: Select Interpreter» и укажите установленную версию вручную. Если списка нет, проверьте установку командой python —version в терминале и перезапустите VS Code после установки Python.
Как исправить ошибку «python не является внутренней или внешней командой»?
Windows не находит Python в PATH. Установите Python 3.14 через Python Install Manager с python.org — он делает команду python доступной из любого терминала. После установки закройте и снова откройте терминал.
Python спроектирован так, чтобы быть простым и интересным в изучении, а VS Code снимает большую часть рутины вокруг него. Если хочется двигаться по плану, начните со статьи «С чего начать изучение Python: 10 простых шагов». А если что-то не заводится — приходите в чат зерокодеров. Там подскажут.