> For the complete documentation index, see [llms.txt](https://utm-1.gitbook.io/utm-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://utm-1.gitbook.io/utm-docs/dokumentaciya/utm-it/programmnoe-obespechenie/rabochie-stancii-windows/po-razrabotchika/vs-code/vs-code.-plaginy-dlya-python.md).

# VS Code. Плагины для Python

## Python

<details>

<summary>Оф<strong>ициальное расширение Python для Visual Studio Code</strong> от Microsoft. Это расширение поддерживает язык Python (для всех активно поддерживаемых версий) и предоставляет точки доступа для других расширений. </summary>

По умолчанию расширение автоматически устанавливает расширения: **Pylance**, **Python Debugger** и **Python Environments**. Эти расширения — необязательные зависимости, расширение Python останется функциональным, если они не установлены.&#x20;

### Ссылки

Ссылка на установку: [marketplace.visualstudio.com](https://marketplace.visualstudio.com/items?itemName=ms-python.python)

Необходимые расширения VS Code для разработчиков Python: [25scripts.com](https://25scripts.com/posts/must-have-vs-code-extensions-for-python-developers/)

Как установить библиотеки Python в Visual Studio Code: [dev.to](https://dev.to/emminex/how-to-install-python-libraries-in-visual-studio-code-38i1)

Установка Python в VS Code и интерпретатор Python не распознаются: [stackoverflow.com](https://tr-page.yandex.ru/translate?lang=en-ru\&url=https%3A%2F%2Fstackoverflow.com%2Fquestions%2F62220904%2Fvs-code-python-installation-and-python-interpreter-not-recognized)

### Функции

Некоторые функции расширения Python:

* **IntelliSense** — редактирование кода с автоматическим завершением, навигацией по коду, проверкой синтаксиса.
* **Linting** — анализ кода с помощью Pylint, Flake8 и других инструментов.
* **Форматирование кода** — с использованием black, autopep или yapf.
* **Отладка** — отладка скриптов Python, веб-приложений, удалённых или многопоточных процессов.
* **Тестирование** — запуск и отладка тестов через «Исследователь тестов» с помощью unittest или pytest.
* **Поддержка Jupyter Notebooks** — создание и редактирование Jupyter Notebooks, добавление и запуск ячеек кода, рендеринг графиков.
* **Автоматическое активирование и переключение между средами** — virtualenv, venv, pipenv, conda и pyenv.
* **Рефакторинг** — реструктуризация кода Python с извлечением переменных и методов.

### Установка

Чтобы установить расширение Python, нужно:

1. **Установить поддерживаемую версию Python** в системе (системная установка Python на macOS не поддерживается).
2. **Установить расширение Python** для Visual Studio Code.
3. **Открыть или создать файл Python** и начать работу.

Если появится запрос, нужно перезагрузить Visual Studio Code, чтобы расширение было загружено и готово к использованию.

### Отзывы

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

</details>

## Python Debugger <sub><mark style="color:green;">(часть плагина Python)<mark style="color:green;"></sub>

<details>

<summary><strong>Python Debugger</strong> — плагин для Visual Studio Code (VS Code), который поддерживает отладку Python-кода с помощью debugpy. </summary>

{% hint style="info" %}
По умолчанию установлен вместе с расширением Python.
{% endhint %}

### Ссылки

Ссылка на установку: [marketplace.visualstudio.com](https://marketplace.visualstudio.com/items?itemName=ms-python.debugpy)

**Репозиторий**: [github.com](https://github.com/microsoft/vscode-python-debugger)

Отладка Python в VS Code: [code.visualstudio.com](https://code.visualstudio.com/docs/python/debugging)

Отладчик Visual Studio Code для Python: как использовать: [tms-dev-blog.com](https://tms-dev-blog.com/visual-studio-code-debugger-for-python-how-to-use/)

Как отлаживать Python в VSCode: [lightrun.com](https://lightrun.com/debug-python-in-vscode/)

Учебник: Как отлаживать код Python в Visual Studio Code: [qodo.ai](https://www.qodo.ai/blog/tutorial-how-to-debug-python-code-in-visual-studio-code/)

Visual Studio Code и Python: как отладка перестала быть болезнью: [dzen.ru](https://dzen.ru/a/Z4DEo6EfLC3U3Bdn)

Как отладить модуль Python в VSCode: [geeksforgeeks.org](https://www.geeksforgeeks.org/python/how-to-debug-a-python-module-in-vscode/)

Отладчик VS Code не работает для Python: [learn.microsoft.com](https://learn.microsoft.com/en-us/answers/questions/724858/vs-code-debugger-not-working-for-python)

### Функции

Плагин позволяет:

* **Устанавливать брейкпоинты** — точки в коде, где выполнение программы временно останавливается.
* **Пошагово просматривать код** — переходить по строкам, входить и выходить из функций.
* **Проверять значения переменных** — видеть изменения в реальном времени.
* **Использовать консоль отладки** — выполнять любой код, оценивать выражения и изменять переменные без изменения основного кода.
* **Настроить брейкпоинты на определённые классы ошибок** (ValueError, KeyError и т. д.), чтобы код автоматически останавливался при их возникновении.

**Поддержка**: плагин работает для различных типов приложений Python: скриптов, веб-приложений, удалённых процессов, многопоточных процессов.

### Настройка

Конфигурации для отладки определяются в файле **launch.json** в папке проекта. Можно задать разные среды, аргументы, даже разные пути к интерпретаторам.

**Некоторые особенности настройки**:

* **Удалённая отладка** — можно настроить launch.json для подключения к удалённому интерпретатору Python, что полезно для отладки кода, работающего на другой машине или в контейнере.
* **Несколько конфигураций** — в launch.json можно поддерживать несколько конфигураций для разных сценариев, например, для основного приложения, для запуска тестов, для отладки с конкретными аргументами командной строки.

### Ошибки

**Некоторые ошибки, которые могут возникать при использовании плагина, и решения**:

* **Плагин не работает** — в этом случае можно попробовать вернуть старую версию расширения или отключить автоматическое обновление в файле settings.json.
* **Брейкпоинт не срабатывает** — в этом случае нужно проверить, не вложена ли функция, где установлен брейкпоинт, в другую функцию.

</details>

## Python Environments <sub><mark style="color:green;">(часть плагина Python)<mark style="color:green;"></sub>

<details>

<summary><strong>Python Environments</strong> — расширение для Visual Studio Code (VS Code), которое помогает управлять окружениями и пакетами Python. Оно поддерживает указание окружений для конкретных файлов, целых папок Python или проектов, включая сценарии с несколькими корнями и монорепозиториями.</summary>

{% hint style="info" %}
По умолчанию установлен вместе с расширением Python.
{% endhint %}

{% hint style="warning" %}
**Важно**: расширение требует версии 2024.23 или позже расширения Python (ms-python.python).
{% endhint %}

### Ссылки

Ссылка на установку: [marketplace.visualstudio.com](https://marketplace.visualstudio.com/items?itemName=ms-python.vscode-python-envs)

Репозиторий в GitHub: [github.com](https://github.com/microsoft/vscode-python-environments)

Выбор интерпретатора python в vs code: [dzen.ru](https://dzen.ru/a/aDPr4REleyMd8-oO)

Как активировать виртуальную среду в Python VS Code: [opstree.com](https://opstree.com/blog/2024/11/29/how-to-activate-virtual-environment-in-python-vs-code/)

Использование окружения Python в VS Code: [vscode-docs-arc.readthedocs.io](https://vscode-docs-arc.readthedocs.io/en/latest/python/environments/)

Среды Python в VS Code: [code.visualstudio.com](https://code.visualstudio.com/docs/python/environments)

### Функции

* **Создание, удаление и управление окружениями**. Поддерживаются, например:
  * **venv** — встроенный менеджер окружения из стандартной библиотеки Python, поддерживает создание окружений (интерактивное и быстрое создание) и поиск существующих окружений;
  * **conda** — менеджер окружения, предоставляемый дистрибутивами conda (например, Anaconda Distribution или conda-forge).
* **Установка и удаление пакетов** в выбранном окружении.
* **Добавление и создание новых проектов Python**. Можно добавлять файлы и папки как проекты и назначать им отдельные окружения.
* **Создание активированных терминалов**. По умолчанию все новые терминалы, которые открываются в VS Code, активируют выбранное окружение.

### Настройка

* **Выбор интерпретатора**. Можно использовать команду «Python: Select Interpreter» из Панели команд (Ctrl+Shift+P или Cmd+Shift+P). Появится список обнаруженных интерпретаторов, включая глобальные интерпретаторы Python и виртуальные окружения.
* **Создание нового виртуального окружения** (если ещё нет) — можно создать его прямо из VS Code: открыть Панель команд, ввести «Python: Create Environment», выбрать тип окружения и базовый интерпретатор Python.
* **Проверка активации окружения** — после выбора интерпретатора в строке состояния VS Code отображается название окружения (например, (.venv) или (venv)).

&#x20;Ошибки

* **Виртуальное окружение не активируется в VS Code** — можно проверить, правильно ли установлен параметр&#x20;

  ```
  python.venvPath
  ```

  &#x20;в настройках рабочей области (.vscode/settings.json). Также стоит перезапустить VS Code после создания виртуального окружения.
* **Чтобы предотвратить автоматическую активацию выбранного окружения**, можно добавить «python.terminal.activateEnvironment»: false в файл настроек рабочей области (.vscode/settings.json).

</details>

## Pylance <sub><mark style="color:green;">(часть плагина Python)<mark style="color:green;"></sub>

<details>

<summary><strong>Pylance</strong> — официальный плагин поддержки языка программирования Python в Visual Studio Code (VS Code) от Microsoft. Работает на основе движка Pyright, который обеспечивает глубокий статический анализ кода с высокой точностью подсказок.</summary>

{% hint style="info" %}
По умолчанию установлен вместе с расширением Python.
{% endhint %}

### Ссылки

Ссылка на установку: [marketplace.visualstudio.com](https://marketplace.visualstudio.com/items?itemName=ms-python.vscode-pylance)

Топ плагинов для Visual Studio Code, которые пригодятся при работе на Python: [ya.zerocoder.ru](https://ya.zerocoder.ru/top-7-plaginov-dlya-visual-studio-code-kotorye-tochno-prigodyatsya-pri-rabote-na-python/)

Pylance: лучшее серверное расширение языка Python для Visual Studio Code: [ecoagi.ai](https://ecoagi.ai/en/topics/Python/pylance-vs-code)

Pylance: лучшее серверное расширение языка Python для Visual Studio Code: [docs.kanaries.net](https://docs.kanaries.net/topics/Python/pylance-vs-code)

Языковой сервер Pylance вышел в релиз: [habr.com](https://habr.com/ru/companies/microsoft/articles/558388/)

### Функции

Некоторые функции плагина Pylance:

* **Динамическая подсветка синтаксиса** — адаптируется в зависимости от контекста написания кода. Позволяет видеть доступные методы, классы и свойства объектов.
* **Автоимпорт** — интеллектуальные предложения по импорту в списке завершений для установленных и стандартных библиотечных модулей. После выбора импорт добавляется в начало файла.&#x20;
* **Справка по сигнатуре функции** — всплывающая подсказка с информацией о параметрах и возвращаемом типе.
* **Навигация по коду** — переход к определению и переход к объявлению, чтобы быстро перейти к пользовательскому коду, исходным файлам (например, .py) или типу файлов (.pyi).
* **Поддержка многокорневых рабочих пространств** — позволяет работать с несколькими проектами Python в одном окне VS Code.

**Важно**: Pylance предназначен для Python 3.5 и новых версий, код Python 2 официально не поддерживается.

### Установка

Плагин Pylance доступен в **Visual Studio Marketplace**. По умолчанию он включён в расширение Python для VS Code в качестве дополнительной зависимости. **Чтобы установить Pylance, нужно**:

1. Открыть VS Code.
2. Перейти в раздел «Расширения» (Ctrl+Shift+X).
3. Найти Pylance в marketplace и нажать кнопку «Установить».

### Настройка

После установки Pylance нужно **настроить его как языковой сервер для Python** в настройках:

1. Открыть настройки (File → Preferences → Settings).
2. Найти «Python Language Server».
3. Выбрать «Pylance» из выпадающего меню.

</details>

## isort

<details>

<summary><strong>isort</strong> — расширение для Visual Studio Code (VS Code), которое позволяет автоматически сортировать и организовывать импорты в Python-коде с помощью утилиты isort. Расширение использует протокол Language Server Protocol (LSP) для запуска isort в режиме, напоминающем сервер. </summary>

### Ссылки

Ссылка на установку: [marketplace.visualstudio.com](https://marketplace.visualstudio.com/items?itemName=ms-python.isort)

Visual Studio Code: установка и настройка для Python: [timeweb.cloud](https://timeweb.cloud/tutorials/code-editor/visual-studio-code-ustanovka-i-nastrojka-dlya-python)

### Функции

* **Интегрированная сортировка импортов**. После установки расширения isort автоматически регистрируется как организатор импортов. Можно использовать:
  * **Действие в редакторе** — «Организовать импорты» (Shift + Alt + O).
  * **Быстрое исправление** — доступно, когда импорты не организованы.
* **Настраиваемые аргументы isort** — можно изменить настройку&#x20;

  ```
  isort.args
  ```

  .
* **Сортировка импортов при сохранении** — можно включить эту функцию для файлов Python, изменив настройку&#x20;

  ```
  editor.codeActionsOnSave
  ```

### Установка

Расширение isort доступно в **Visual Studio Marketplace**.

**Важно**: расширение поддерживает все активно поддерживаемые версии языка Python, минимальная версия isort — 6.0.0.

### Настройка

Некоторые настройки расширения isort:

* **isort.path** — путь к бинарному isort, который будет использоваться расширением.
* **isort.interpreter** — путь к исполняемому файлу Python или команде, которая будет использоваться для запуска сервера isort и любого подпроцесса.
* **isort.importStrategy** — определяет, какой бинарный isort будет использоваться для анализа файлов Python. Например,&#x20;

  ```
  useBundled
  ```

  &#x20;— расширение использует бинарный isort, который идёт с расширением, или&#x20;

  ```
  fromEnvironment
  ```

  &#x20;— расширение пытается использовать бинарный isort и все зависимости, которые доступны в текущей выбранной среде.
* **isort.showNotification** — контролирует, когда будут отображаться уведомления расширения. Принимаемые значения: onError, onWarning, always и off.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://utm-1.gitbook.io/utm-docs/dokumentaciya/utm-it/programmnoe-obespechenie/rabochie-stancii-windows/po-razrabotchika/vs-code/vs-code.-plaginy-dlya-python.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.