Быть в курсе
Аватарка автора Редакция Рег.облако
Облако

Настройка Visual Studio Code для Python

8 сентября 2026

14 минут

Телеграм

ВКонтакте

Если вы пишете код на Python, рано или поздно встает вопрос: в чем его писать. Вариантов масса — от блокнота до тяжелых IDE вроде PyCharm. Visual Studio Code — отличный компромисс: он легкий, но при этом умеет почти все, что нужно для комфортной работы.  

Мы покажем, как поставить редактор, добавить нужные расширения, создать виртуальное окружение, запустить скрипт и настроить отладку. 

Почему Visual Studio Code популярен среди Python-разработчиков

Python-разработчики выбирают VS Code по одной простой причине: редактор бесплатный, работает одинаково на Windows, macOS и Linux, и при этом не тормозит даже на слабом железе. 

PyCharm и другие полноценные среды разработки грузят систему заметно сильнее — VS Code же запускается за пару секунд и не отбирает память под функции, которые в конкретном проекте никогда не понадобятся.

VS Code подходит и для небольших учебных скриптов, и для крупных проектов. При этом его не нужно сразу настраивать целиком: дополнительные инструменты можно подключать по мере необходимости.

Установка Visual Studio Code

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

Зайдите на официальный сайт Visual Studio и нажмите кнопку загрузки — сайт сам определит операционную систему и предложит нужный файл (для Windows это .exe, для macOS — ZIP, для Linux — DEB или RPM, в зависимости от дистрибутива):

Запустите скачанный файл. 

Windows

На Windows откроется мастер установки — согласитесь с лицензией и на шаге с дополнительными опциями отметьте «Add to PATH»: это позволит запускать редактор из командной строки командой code. 

Когда редактор нужен для работы с кодом, важно быстро подготовить рабочее окружение без лишних настроек. Готовый образ Windows от Рег.облака позволяет развернуть систему в облаке и сразу перейти к работе с привычными инструментами разработки, не тратя время на самостоятельную установку и настройку ОС.

macOS

На macOS достаточно распаковать архив и перетащить VS Code.app в папку «Программы». 

Linux

На Linux пакет ставится через менеджер пакетов дистрибутива — например, для Ubuntu: 

Запустите Visual Studio Code. При первом старте редактор предложит выбрать тему оформления, темную или светлую — это можно поменять в любой момент через настройки:

На этом установка самого редактора закончена. Дальше нужно добавить в него Python и расширение, которое умеет с ним работать.

Важно: подробнее весь процесс, как установить Visual Studio Code на Linux, Windows и macOS, рассмотрели в руководстве «Python & VS Code: руководство по сборке рабочего окружения». 

Установка Python и проверка окружения

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

Windows

Скачайте Python Install Manager с официального сайта Python или установите его через Microsoft Store. Затем установите актуальную стабильную версию Python 3.

Если программа установки предлагает добавить Python в PATH, разрешите это. PATH — список папок, в которых Windows ищет программы при вводе команд в терминале.

Откройте PowerShell или командную строку и выполните:

Если команда не сработала, попробуйте:

В ответ должна появиться установленная версия, например:

Конкретный номер может отличаться.

macOS

Скачайте установочный пакет PKG с сайта Python и пройдите стандартную установку. Официальный пакет подходит как для компьютеров с процессорами Intel, так и для Mac с Apple Silicon.

Откройте «Терминал» и выполните:

На macOS используйте команду python3, поскольку команда python может отсутствовать или относиться к другой установке.

Linux

В большинстве дистрибутивов Linux Python уже установлен. Проверьте его командой:

Если терминал сообщает, что команда не найдена, установите Python через менеджер пакетов своего дистрибутива. Например, в Ubuntu и Debian:

Пакет python3-venv нужен для создания виртуальных окружений. В других дистрибутивах названия пакетов могут отличаться. Python доступен в репозиториях большинства Linux-систем.

Проверка pip

Вместе с Python устанавливается pip — инструмент для загрузки сторонних библиотек. Проверьте его через интерпретатор Python:

Windows:

Если вы используете команду py, команда будет иной:

macOS и Linux:

Команда должна вывести версию pip и путь к папке Python. Если версия Python отображается, а pip не найден, его придется установить отдельно или исправить текущую установку Python:

Чтобы узнать, какой файл интерпретатора запускается системой, выполните:

Windows: where python

macOS и Linux: which python3

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

Установка необходимых расширений

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

  1. Откройте раздел «Расширения» на боковой панели или нажмите Ctrl+Shift+X в Windows и Linux либо Cmd+Shift+X в macOS.
  2. Введите в поиске Python.
  3. Выберите расширение с издателем Microsoft:
  1. Нажмите Установить.

Вместе с ним VS Code автоматически устанавливает еще три расширения:

  • Pylance отвечает за автодополнение, подсказки, переход к определениям и поиск ошибок в коде;
  • Python Debugger позволяет выполнять программу по шагам, ставить точки остановки и проверять значения переменных;
  • Python Environments помогает выбирать и создавать окружения, а также управлять установленными пакетами.

Устанавливать их вручную не требуется. Они добавляются как зависимости основного расширения Python.

Полезные расширения для разработки на Python

Помимо базового расширения Python и ему сопутствующих, вам могут пригодиться:

  • Ruff проверяет код, форматирует его и упорядочивает импорты. Подходит тем, кто хочет закрыть несколько задач одним расширением.
  • Black Formatter автоматически форматирует Python-код по правилам Black. Устанавливайте его, если этот форматтер используется в проекте.
  • Jupyter добавляет поддержку блокнотов .ipynb. Нужен для анализа данных, машинного обучения и учебных проектов на Jupyter Notebook.
  • isort сортирует и группирует строки импорта. Не нужен, если эту задачу уже выполняет Ruff.
  • Even Better TOML упрощает работу с файлами pyproject.toml, в которых хранят настройки проекта и инструментов разработки.

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

Настройка Python Interpreter

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

  1. Откройте папку проекта в VS Code.
  2. Нажмите Ctrl+Shift+P в Windows и Linux или Cmd+Shift+P в macOS.
  3. Введите команду Python: Выбор интерпретатора:
  1. Выберите нужную версию Python из списка:

Если в проекте есть виртуальное окружение .venv, выбирайте интерпретатор из этой папки. 

Для нового проекта лучше создать отдельное виртуальное окружение. Тогда его библиотеки не смешаются с пакетами других проектов.

Выбрав версию Python, откройте новый терминал через меню «Терминал» → «Создать новый терминал» и проверьте версию:

На некоторых компьютерах с macOS или Linux для глобальной установки используется команда:

Номер версии в терминале должен совпадать с версией, выбранной в строке состояния. Новые терминалы VS Code автоматически активируют выбранное окружение. Если терминал был открыт до смены интерпретатора, закройте его и создайте заново.

Если нужной версии нет в списке, убедитесь, что Python установлен, а затем перезапустите VS Code. Для повторного поиска окружений откройте палитру команд и выполните Python Environments: Refresh All Environment Managers.

Создание и подключение виртуального окружения

Виртуальное окружение — это отдельная изолированная копия Python для конкретного проекта со своим набором библиотек. Без него все пакеты ставятся в общую системную установку, и рано или поздно два проекта потребуют разные версии одной и той же библиотеки — тогда что-то одно сломается. Отдельное окружение на каждый проект снимает эту проблему полностью.

Создать окружение можно через командную строку:

Или вручную в VS Code:

  1. Откройте папку проекта.
  2. Вызовите палитру команд сочетанием Ctrl+Shift+P в Windows и Linux или Cmd+Shift+P в macOS.
  3. Найдите команду Python: Создать среду:
  1. Выберите venv:
  1. Укажите версию Python, на основе которой нужно создать окружение:
  1. Задайте имя окружения:

Важно: если VS Code предложит установить зависимости из requirements.txt или pyproject.toml, выберите нужный файл. Или пропустите установку. 

VS Code создаст папку .venv и подключит новое окружение к проекту. В новых терминалах оно будет активироваться автоматически:

Проверьте подключение командой:

В полученном пути должна присутствовать папка .venv:

Настройка автодополнения и подсказок кода

За автодополнение Python-кода в VS Code отвечает расширение Pylance. Оно устанавливается вместе с основным расширением Python и показывает доступные функции, методы, параметры и документацию прямо во время набора кода.

Дополнительная настройка чаще всего не требуется. Откройте файл с расширением .py, выберите интерпретатор и начните писать код. Например, после ввода:

VS Code покажет список доступных функций и классов. Например:

Если подсказки не появились автоматически, нажмите Ctrl+Space. На macOS используется сочетание Control+Space.

Pylance также умеет автоматически добавлять строки импорта. Эта функция по умолчанию отключена. Чтобы включить ее:

  1. Через палитру выберите Параметры: Открыть параметры (пользовательский интерфейс).
  2. Найдите параметр Auto Import Completions.
  3. Включите Python › Analysis: Auto Import Completions:

Ту же настройку можно добавить в файл settings.json:

После этого Pylance сможет предлагать функции и классы из модулей проекта и установленных библиотек, а при выборе подсказки добавит нужный import.

Уровень строгости проверки типов настраивается в settings.json — файле конфигурации редактора, который открывается через палитру команд по запросу "Параметры: Открыть пользовательские настройки (JSON)». Добавьте туда:

Режим basic подсвечивает явные ошибки — например, вызов метода у переменной не того типа, — но не придирается к каждой мелочи. В режиме off проверка типов отключена, а strict, наоборот, включает наиболее строгий набор проверок.

Настройка линтеров и форматтера

Линтер проверяет код на ошибки и нарушения стиля еще до запуска — например, найдет неиспользуемую переменную или несоответствие стандарту PEP 8 (общепринятому своду правил оформления кода на Python). Форматтер решает другую задачу: автоматически приводит отступы, пробелы и переносы строк к единому виду, чтобы не следить за этим руками.

Самый популярный выбор сейчас — Ruff. Он объединяет линтер и форматтер в одном расширении и работает заметно быстрее старых связок вроде Pylint с Black, потому что написан на Rust. Поставьте расширение Ruff из маркетплейса, затем добавьте в settings.json:

Параметр formatOnSave заставляет редактор форматировать файл автоматически при каждом сохранении — не нужно вызывать команду форматирования вручную. 

Если в проекте уже настроен Black или flake8 и переходить на Ruff пока не хочется, их тоже можно подключить через отдельные расширения — логика та же: ставите расширение, указываете его форматтером по умолчанию для Python.

Часть правил линтера можно настроить под себя — например, отключить конкретную проверку, если она конфликтует со стилем проекта. Делается это через файл pyproject.toml в корне проекта или прямо в настройках расширения.

Работа с отладчиком в VS Code

Отладчик позволяет остановить выполнение программы в нужном месте и посмотреть, что происходит с переменными, вместо того чтобы расставлять по коду print() и гадать, где закралась ошибка.

Для запуска отладки:

  1. Откройте Python-файл.
  2. Нажмите слева от номера строки, на которой нужно остановить программу. Появится красная точка — точка остановки:
Точка остановки в VS Code
  1. Нажмите F5 или откройте раздел Запуск и отладка и выберите Python Debugger: Debug Python File:
Опция Python Debugger: Debug Python File
  1. Когда выполнение остановится, проверьте значения в панели Переменные или наведите указатель на переменную в коде:
Режим отладки в VS Code

Во время отладки доступны основные команды:

  • F5 — продолжить выполнение до следующей точки останова;
  • F10 — выполнить текущую строку, не заходя внутрь вызываемой функции;
  • F11 — перейти внутрь функции;
  • Shift+F11 — выйти из функции;
  • Shift+F5 — остановить программу.

Запуск Python-скриптов через редактор

Откройте файл с расширением PY и нажмите кнопку Запустить файл Python на выделенном терминале в правом верхнем углу редактора. VS Code откроет терминал, активирует выбранное окружение и запустит файл:

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

Также вы можете запустить файл вручную через терминал:

На macOS и Linux для системной установки Python часто используется команда:

Чтобы выполнить отдельный фрагмент, выделите нужные строки и нажмите Shift+Enter. VS Code отправит их в REPL — интерактивный режим Python, который сразу выполняет введенный код и показывает результат.

Когда локальное окружение настроено и приложение готово к тестированию вне компьютера разработчика, его можно перенести на облачные серверы Рег.облака. На виртуальном сервере можно установить нужную версию Python, развернуть зависимости проекта и настроить окружение, приближенное к рабочему.

Итоги

Грамотно настроенный Visual Studio Code заметно ускоряет разработку на Python: подсветка синтаксиса, автодополнение, отладка и линтинг помогают сразу замечать ошибки и писать чистый код. С базовыми расширениями и правильной конфигурацией редактор становится удобной средой как для небольших скриптов, так и для серьезных проектов — остается только сосредоточиться на решении задач.

Частые вопросы

Подходит ли Visual Studio Code для профессиональной разработки на Python?

Да, крупные компании используют его наравне с PyCharm — редактор справляется и с большими кодовыми базами, и с командной работой.

Чем VS Code отличается от PyCharm?

PyCharm — полноценная среда разработки, которая заточена конкретно под Python: многие инструменты вроде отладчика, тестов и рефакторинга работают в ней из коробки, без установки расширений. 

А VS Code — универсальный редактор, который подстраивается под язык через расширения, весит меньше и запускается быстрее, но требует ручной настройки под конкретные задачи.

Можно ли использовать VS Code для Django и Flask?

Да, оба фреймворка работают без проблем. Для Django есть расширение Django, которое подсвечивает синтаксис шаблонов и добавляет автодополнение для тегов. 

Для Flask отдельное расширение не обязательно — хватает базовой связки Python и Pylance, а запуск сервера разработки настраивается через launch.json.

Почему VS Code не видит установленный Python?

Чаще всего причина в том, что редактор не может найти путь к интерпретатору. Откройте палитру команд (Ctrl+Shift+P) и выполните «Python: Выбор интерпретатора». Если Python в списке не появился, проверьте, что при установке была отмечена галочка «Add to PATH» на Windows, или переустановите Python с сайта, если ставили его через сторонний источник.

Подходит ли VS Code для начинающих?

Да, VS Code хорошо подходит для начинающих. А с расширением Code Runner запускать код можно буквально в один клик — не придется сразу разбираться в сложных конфигурациях.

Новые статьи