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

Чтобы писать на Python в VS Code, нужны три вещи: установленный Python, сам редактор VS Code и бесплатное расширение Python от Microsoft. Короткая схема: установите VS Code с code.visualstudio.com, откройте вкладку расширений (Ctrl+Shift+X), найдите и установите «Python» от Microsoft, затем через палитру команд (Ctrl+Shift+P) выполните Python: Select Interpreter и выберите нужный Python.

Ниже — подробная настройка VS Code для Python по шагам: виртуальное окружение, запуск и отладка, автоформатирование и линтер Ruff, Jupyter-ноутбуки и решения частых проблем. Сочетания клавиш указаны для Windows и Linux; в macOS вместо Ctrl нажимайте Cmd.

Как установить среду разработки для Python

VS Code (Visual Studio Code) — бесплатный редактор кода от Microsoft. Сам по себе он «не знает» Python: подсветку, автодополнение, запуск и отладку добавляет расширение. Поэтому установка среды разработки состоит из трёх частей, и ставить их удобно в таком порядке.

Python. Редактор не устанавливает интерпретатор — его нужно поставить отдельно. Как это сделать на любой системе, описано в руководстве «Как установить Python». Проверьте результат в терминале: python --version в Windows или python3 --version в macOS и Linux.

VS Code. Скачайте установщик для своей системы с code.visualstudio.com:

• Windows — установщик User Installer ставит редактор для текущего пользователя без прав администратора. На шаге дополнительных задач оставьте отмеченным пункт «Add to PATH» (он позволяет открывать папки командой code .) и при желании отметьте пункты «Open with Code» для контекстного меню Проводника.
• macOS — скачайте архив, перетащите Visual Studio Code в папку «Программы». Чтобы работала команда code в Терминале, откройте палитру команд и выполните Shell Command: Install 'code' command in PATH.
• Linux — пакеты .deb (Ubuntu, Debian) и .rpm (Fedora) есть на сайте, также доступна установка через Snap.

Русский интерфейс включается расширением «Russian Language Pack for Visual Studio Code». В статье названия команд даны на английском — так их удобнее искать в палитре команд при любом языке интерфейса.

Расширение Python. Откройте вкладку Extensions (Ctrl+Shift+X), введите Python и установите расширение Python от издателя Microsoft (идентификатор ms-python.python). Вместе с ним по умолчанию установятся:

Расширение	За что отвечает
Pylance	автодополнение, подсказки типов, переход к определению, поиск ошибок
Python Debugger	отладка через debugpy: точки останова, пошаговое выполнение
Python Environments	управление окружениями и пакетами (включается настройкой python.useEnvironmentsExtension)

Совет: в магазине расширений много сторонних пакетов со словом Python в названии. Проверяйте издателя — нужно расширение от Microsoft с синей галочкой подтверждённого издателя.

Откройте папку проекта

VS Code привязывает настройки, окружение и конфигурации запуска к открытой папке, поэтому работайте с папкой проекта, а не с отдельными файлами. Создайте папку проекта и откройте её через File → Open Folder или из терминала:

mkdir my_project
cd my_project
code .

При первом открытии VS Code спросит, доверяете ли вы авторам файлов в папке, — для своих проектов отвечайте «Yes, I trust the authors». В режиме ограниченного доступа часть функций расширений отключена.

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

Интерпретатор, выбранный в VS Code, определяет, каким Python запускается код и где Pylance ищет установленные библиотеки. Выбрать его можно двумя способами:

1. Палитра команд Ctrl+Shift+P → Python: Select Interpreter.
2. Щелчок по версии Python в строке состояния внизу окна (она видна, когда открыт файл .py).

В списке будут все найденные интерпретаторы: системные, установленные через Python Install Manager, Homebrew или pyenv, а также виртуальные окружения в папке проекта. Если нужного нет, выберите пункт Enter interpreter path... и укажите путь к python.exe (Windows) или python3 (macOS, Linux) вручную. Как узнать, какие версии стоят на компьютере, — в статье «Как узнать версию Python».

Виртуальное окружение в VS Code

Для каждого проекта создавайте отдельное виртуальное окружение — тогда библиотеки разных проектов не конфликтуют. В VS Code это делается без терминала:

1. Ctrl+Shift+P → Python: Create Environment.
2. Выберите тип Venv (для Conda нужен установленный Anaconda или Miniconda).
3. Выберите базовый интерпретатор, на основе которого создаётся окружение.
4. Если в проекте есть requirements.txt или pyproject.toml, VS Code предложит сразу установить зависимости из него.

Если на компьютере установлен uv, расширение Python Environments создаёт окружение и ставит пакеты через него — так быстрее.

Окружение появится в папке .venv проекта и будет автоматически выбрано как интерпретатор. То же самое можно сделать вручную во встроенном терминале (Ctrl+`):

python -m venv .venv      # Windows
python3 -m venv .venv     # macOS, Linux

После этого выберите .venv через Python: Select Interpreter. Когда интерпретатор из окружения выбран, VS Code по умолчанию активирует окружение в каждом новом терминале — в начале строки приглашения появится (.venv). Библиотеки ставьте в этом терминале обычной командой python -m pip install requests; подробнее — в статье о pip.

Важно: папку .venv не добавляйте в Git — запишите её в .gitignore, а список зависимостей храните в requirements.txt.

Запуск Python-кода

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

name = input("Как вас зовут? ")
print(f"Привет, {name}!")

Способы запуска:

Способ	Что происходит
Кнопка ▶ в правом верхнем углу редактора	Run Python File — запуск файла во встроенном терминале
Ctrl+Shift+P → Python: Run Python File in Terminal	то же через палитру команд
Выделить строки → Shift+Enter	выполнить выделенный код в интерактивной сессии Python
F5	запуск под отладчиком (см. ниже)
python main.py во встроенном терминале	обычный запуск, как в любом терминале

Все способы используют выбранный интерпретатор. Программа с input() работает во встроенном терминале — вводите ответ прямо там. Другие способы запуска скриптов, аргументы командной строки и запуск двойным щелчком описаны в статье «Как запустить Python-скрипт».

Отладка Python в VS Code

Отладчик позволяет остановить программу на нужной строке и посмотреть значения переменных.

1. Поставьте точку останова: щёлкните слева от номера строки (появится красная точка) или нажмите F9.
2. Нажмите F5 и выберите Python Debugger: Current File.
3. Программа остановится на точке останова. Слева, на панели Run and Debug, видны переменные, стек вызовов и выражения для наблюдения.

Управление выполнением:

Клавиша	Действие
F5	продолжить до следующей точки останова
F10	выполнить строку, не заходя в функции (Step Over)
F11	зайти внутрь вызываемой функции (Step Into)
Shift+F11	выйти из текущей функции (Step Out)
Shift+F5	остановить отладку

Чтобы сохранить настройки запуска — аргументы командной строки, переменные окружения, рабочую папку, — на панели Run and Debug нажмите create a launch.json file. VS Code создаст файл .vscode/launch.json:

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Python Debugger: Current File",
      "type": "debugpy",
      "request": "launch",
      "program": "${file}",
      "console": "integratedTerminal",
      "args": ["--verbose"]
    }
  ]
}

Поле args здесь добавлено для примера — оно передаёт аргументы в программу. Для проектов Django и FastAPI при создании launch.json есть готовые шаблоны конфигураций.

Форматирование и линтер: Ruff

Ruff — быстрый линтер и форматтер для Python: находит ошибки и неиспользуемые импорты, сортирует импорты и форматирует код в стиле, совместимом с Black. Установите расширение Ruff (издатель Astral Software, идентификатор charliermarsh.ruff) — исполняемый файл Ruff уже встроен в расширение, отдельно ставить пакет не обязательно.

Чтобы код форматировался при каждом сохранении, откройте пользовательский settings.json (Ctrl+Shift+P → Preferences: Open User Settings (JSON)) и добавьте:

{
  "[python]": {
    "editor.defaultFormatter": "charliermarsh.ruff",
    "editor.formatOnSave": true,
    "editor.codeActionsOnSave": {
      "source.fixAll": "explicit",
      "source.organizeImports": "explicit"
    }
  }
}

Если в settings.json уже есть другие настройки, добавьте блок "[python]" внутрь существующих фигурных скобок, не создавая второй объект. Теперь при Ctrl+S Ruff отформатирует файл, исправит то, что умеет исправлять автоматически, и упорядочит импорты. Правила Ruff для проекта (длина строки, набор проверок) задаются в pyproject.toml в секции [tool.ruff].

Если в команде принят Black, вместо Ruff можно поставить расширение Black Formatter от Microsoft и указать его в editor.defaultFormatter.

Jupyter-ноутбуки в VS Code

Для анализа данных удобно работать в ноутбуках прямо в редакторе. Установите расширение Jupyter от Microsoft, создайте файл с расширением .ipynb и выберите ядро (кнопка Select Kernel справа вверху) — укажите интерпретатор из окружения проекта. Если в окружении нет пакета ipykernel, VS Code предложит его установить.

Без отдельного файла ноутбука можно разбить обычный .py-файл на ячейки комментарием # %% — над каждой ячейкой появится кнопка Run Cell, а результат откроется в интерактивном окне.

Частые проблемы

Import “requests” could not be resolved

Pylance подчёркивает импорт, потому что библиотека не установлена в выбранный интерпретатор. Проверьте интерпретатор в строке состояния и установите пакет именно в него: откройте новый терминал VS Code (окружение активируется) и выполните python -m pip install requests. Тот же корень у ошибки при запуске — подробный разбор в статье про ModuleNotFoundError.

В списке интерпретаторов нет установленного Python

Перезапустите VS Code после установки Python — список интерпретаторов обновляется не сразу. Если не помогло, выберите Enter interpreter path... и укажите путь к исполняемому файлу вручную.

Окружение не активируется в PowerShell

Ошибка вида «выполнение сценариев отключено в этой системе» означает, что политика выполнения PowerShell блокирует скрипт Activate.ps1. Решение описано в статье о виртуальном окружении. Как временный обходной путь можно переключить терминал VS Code на Command Prompt через выпадающий список рядом со значком + на панели терминала.

Python was not found; run without arguments to install from the Microsoft Store

Команда python в Windows перехватывается заглушкой Microsoft Store. Установите Python и отключите псевдонимы python.exe и python3.exe в параметрах Windows (раздел псевдонимов выполнения приложений), либо пользуйтесь командой py.

input() не работает при запуске через Code Runner

Стороннее расширение Code Runner по умолчанию (code-runner.runInTerminal: false) выводит результат в панель Output, которая доступна только для чтения, — ввести данные для input() там нельзя. Запускайте код кнопкой ▶ расширения Python или включите в настройках Code Runner параметр code-runner.runInTerminal: тогда код будет выполняться во встроенном терминале. Учтите, что Code Runner запускает файл своей командой и может взять не тот интерпретатор, который выбран в Python: Select Interpreter.

Код запускается не той версией Python

Кнопка ▶ и F5 используют интерпретатор из строки состояния, а команда python в терминале — то, что первым найдено в PATH (или активное окружение). Выберите интерпретатор через Python: Select Interpreter и откройте новый терминал.

Чек-лист настройки

• Python установлен, python --version (или python3 --version) работает в терминале.
• Установлены VS Code и расширение Python от Microsoft.
• Папка проекта открыта через File → Open Folder.
• Создано окружение .venv и выбрано как интерпретатор.
• Скрипт запускается кнопкой ▶ и под отладчиком по F5.
• Ruff форматирует код при сохранении.

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

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

Это разные продукты Microsoft. VS Code — лёгкий бесплатный редактор для Windows, macOS и Linux, который получает поддержку языков через расширения. Visual Studio — полноценная IDE для Windows, рассчитанная в первую очередь на C#, .NET и C++; для Python в ней есть отдельная рабочая нагрузка, но большинство Python-разработчиков выбирают VS Code или PyCharm.

Что выбрать для Python: VS Code или PyCharm?

VS Code подходит, если вы пишете не только на Python или любите собирать среду из расширений: он быстро запускается и бесплатен. PyCharm сразу умеет всё основное для Python — рефакторинг, отладку, запуск тестов — и почти не требует настройки; расширенные возможности, например поддержка Django и инструменты для баз данных, доступны по платной подписке. Для учёбы годятся оба; попробуйте каждый на небольшом проекте.

Как запускать тесты pytest в VS Code?

Выполните Python: Configure Tests, выберите pytest и папку с тестами. После этого на панели Testing (значок колбы) появится дерево тестов: их можно запускать по одному, целыми файлами и под отладчиком. Сам pytest должен быть установлен в выбранное окружение: python -m pip install pytest.

Как открыть интерактивный Python прямо в VS Code?

Команда Python: Start Terminal REPL открывает в терминале интерактивный Python выбранного интерпретатора. Если выделить строки в редакторе и нажать Shift+Enter, они отправятся в эту же сессию.

Как задать настройки только для одного проекта?

Откройте Preferences: Open Workspace Settings (JSON) — VS Code создаст в проекте файл .vscode/settings.json. Настройки из него действуют только в этой папке и перекрывают пользовательские, поэтому туда удобно записать, например, правила форматирования, общие для команды.

Итог

Настройка VS Code для Python сводится к установке расширения Python от Microsoft, выбору интерпретатора и созданию виртуального окружения через Python: Create Environment. Дальше код запускается кнопкой ▶, отлаживается по F5, а Ruff поддерживает порядок в коде. Если Python ещё не установлен, начните с руководства «Как установить Python»; все материалы о рабочем окружении собраны в разделе «Установка Python и настройка окружения». Полная документация — в разделе Python в документации VS Code.