Мы рады объявить, что релиз ноября 2025 года расширения Python для Visual Studio Code теперь доступен!
Этот релиз включает следующие объявления:
- Добавление сводок Copilot во всплывающих подсказках в качестве docstring
- Локализованные сводки Copilot во всплывающих подсказках
- Действие кода для преобразования импортов с wildcard
- Поддержка отладчика для нескольких интерпретаторов через расширение Python Environments
Если вас интересует, вы можете ознакомиться с полным списком улучшений в наших чейнджлогах для расширений Python и Pylance.
Анонс обновления (релиза) бесплатного инструмента для программирования на Python внутри Visual Studio Code (VS Code) — популярной программы для написания кода, как текстовый редактор с суперсилами. Обновление вышло в ноябре 2025 года и добавляет удобные фичи, чтобы программировать было проще и быстрее. Представьте, что VS Code — это мастерская для кодеров, а Python-расширение — набор инструментов специально для языка Python.
- Сводки Copilot в подсказках как docstring. Copilot — это ИИ-помощник (как умный автозаполнитель). Теперь он может показывать краткое объяснение функции прямо в подсказке, как будто это встроенная справка (docstring). Пример: Вы наводите мышку на функцию print("Привет") — всплывает подсказка: "Выводит текст на экран. Используйте для сообщений пользователю".
- Локализованные сводки Copilot. Те же подсказки от ИИ теперь переводятся на ваш язык (например, русский), чтобы не мучиться с английским. Пример: Вместо английского "This function sorts a list" вы видите "Эта функция сортирует список" — удобно для русскоязычных новичков.
- Преобразование импортов с wildcard. Автоматически исправляет "ленивые" импорты (когда вы пишете from module import *), превращая их в точный список нужных вещей. Это делает код чище и быстрее.* Пример: Было: from math import. Стало: from math import sin, cos, pi — VS Code сам предлагает это одним кликом.
- Отладка для нескольких версий Python. Теперь можно легко переключаться и отлаживать код (находить ошибки) между разными версиями Python или виртуальными окружениями через новое расширение Python Environments. Пример: У вас Python 3.10 для одного проекта и 3.12 для другого. Выбираете нужный в списке — и отладчик работает без хлопот, как смена инструментов в ящике.
Эти обновления бесплатны — просто обновите расширение в VS Code. Если вы новичок, начните с установки Python-расширения: оно добавит подсветку кода, автодополнение и запуск скриптов одним кликом.
Добавление сводок Copilot в виде docstring
Теперь вы можете добавить сгенерированную ИИ документацию прямо в свой код в качестве docstring с помощью новой команды «Добавить как docstring» в сводках Copilot во всплывающих подсказках. Когда вы генерируете сводку для функции или класса, перейдите к определению символа и наведите на него курсор, чтобы получить доступ к команде «Добавить как docstring», которая вставляет сводку ниже курсора в формате правильного docstring.
Это упрощает процесс документирования вашего кода, позволяя быстро улучшить читаемость и поддерживаемость без повторного набора текста.
Это новая фича в VS Code с расширением Python (и Copilot — ИИ-помощником). Она позволяет автоматически превращать подсказки от ИИ (краткие объяснения кода) в настоящую документацию внутри вашего кода — так называемый docstring. Docstring — это просто текст с описанием функции, который пишется прямо в коде под тройными кавычками. Раньше приходилось копировать вручную, теперь — одним кликом.
Представьте: вы пишете код, ИИ подсказывает «что это делает», и вы вставляете это как заметку в код — для себя и других.
- Генерация сводки ИИ. Наводите мышку на функцию или класс — Copilot показывает всплывающую подсказку с объяснением. Пример: Для функции def sum(a, b): return a + b ИИ пишет: «Складывает два числа и возвращает сумму».
- Команда «Добавить как docstring». Кликните правой кнопкой или через меню в подсказке — выбираете «Add as docstring» (теперь «Добавить как docstring»). Пример: Курсор под функцией — вставляется готовый текст:
def sum(a, b):
"""Складывает два числа и возвращает сумму."""
return a + b
- Почему это круто. Код становится самодокументирующимся: любой увидит, зачем функция нужна, без лишних файлов. Ускоряет работу, снижает ошибки. Пример в действии: В команде пишете калькулятор — docstring сразу объясняет: «Принимает список чисел, считает среднее» — и код читается как книга.
Устанавливается автоматически с обновлением Python-расширения. Идеально для новичков — учит документировать код правильно.
Локализованные сводки Copilot во всплывающих подсказках.
Сводки GitHub Copilot во всплывающих подсказках внутри Pylance теперь учитывают язык отображения в VS Code. Когда вы вызываете сводку, сгенерированную ИИ, вы получите текст на языке, установленном в вашем редакторе, что упрощает понимание генерируемой документации.
Это обновление делает ИИ-подсказки (Copilot Hover Summaries) в VS Code умнее: они теперь появляются на вашем языке интерфейса, а не только на английском. Pylance — это «мозг» для Python в VS Code, который работает с Copilot. Если вы поставили русский в настройках VS Code, все объяснения кода от ИИ тоже будут по-русски. Нет больше гуглинга переводов!
Представьте: наводите мышку на код — и вместо «This function returns a list» видите «Эта функция возвращает список». Просто и удобно для всех, кто не фанат английского.
- Настройка языка в VS Code. Идите в настройки (Ctrl + ,), найдите «Display Language» и выберите «Русский». Перезапустите VS Code. Пример: Раньше всё на английском, теперь интерфейс и подсказки на русском.
- Вызов подсказки Copilot. Наведите на функцию/класс или нажмите комбинацию клавиш — появляется всплывашка с объяснением на вашем языке. Пример: Для numbers = [1, 2, 3] ИИ скажет: «Список целых чисел: » вместо английского.
- Преимущества для понимания. Легче учить код: документация сразу понятна, без словарей. Работает для функций, классов, переменных. Пример: Наводите на def greet(name): print(f'Привет, {name}!') — подсказка: «Функция приветствия пользователя по имени».
Автоматически включается после обновления расширений Python и Pylance. Если Copilot не установлен, сначала добавьте его из marketplace.
Преобразование wildcard-импортов через Code Action.
Wildcard-импорты (from module import ) часто не рекомендуются в Python, поскольку они могут засорять пространство имён и делать неясным, откуда берутся имена, что снижает ясность кода и его поддерживаемость.
Pylance теперь помогает очистить модули, которые всё ещё используют from module import, с помощью нового Code Action. Он заменяет wildcard на явные символы, сохраняя псевдонимы и оставляя импорт в одной строке. Чтобы попробовать, кликните на строку с wildcard-импортом и нажмите Ctrl + . (или Cmd + . на macOS), чтобы выбрать Code Action "Convert to explicit imports".
Это новая функция в VS Code с Pylance (Python-«мозг» для редактора), которая автоматически исправляет «лёгкие», но вредные импорты в коде. Wildcard-импорт from module import * — как сказать «загрузи всё из модуля», но это засоряет код лишними вещами, и сложно понять, что откуда взялось. Теперь одним кликом Pylance превращает это в точный список нужного — код становится чище и понятнее.
Представьте: вы берёте инструменты из ящика «всё подряд», а потом редактор сам раскладывает только нужные.
Проблема wildcard-импортов: from math import загружает всё из math (sin, cos, pi и 100+ функций), даже если нужно только 2-3. Код тормозит, путается. Пример: используете только sqrt и pi, но тянете весь модуль — как тащить чемодан ради зубной щётки.
Как активировать исправление: наведите на строку from math import, нажмите Ctrl + . (Ctrl-точка) — появится меню, выберите "Convert to explicit imports". Пример: Было: from math import*.
Стало: from math import sqrt, pi — только то, что реально используете.* Что сохраняется и зачем это нужно: псевдонимы (как import numpy as np) остаются, строка одна. Код читается как книга: видно все зависимости сразу, меньше ошибок. Пример до/после:
Было (плохо):
from random import *
num = randint(1, 10)
Стало (хорошо):
from random import randint
num = randint(1, 10)
Теперь ясно: random только для randint, нет сюрпризов.
Автоматически подсвечивает проблемные импорты. Идеально для новичков — учит чистому коду по правилам Python (PEP 8).
Поддержка отладчика для нескольких интерпретаторов через расширение Python Environments.
Расширение Python Debugger теперь использует API из расширения Python Environments (vscode-python-debugger#849). Когда функция включена, отладчик может распознавать и использовать разные интерпретаторы для каждого проекта в рабочем пространстве. Если у вас настроено несколько папок как проекты — каждая со своим интерпретатором — отладчик теперь будет учитывать эти выборы и использовать интерпретатор, показанный в строке состояния, при отладке. Чтобы включить эту функцию, установите "python.useEnvironmentsExtension": true в пользовательских настройках. Новая интеграция API активна только при включенной этой настройке. Сообщайте о любых проблемах в репозиторий Python Debugger.
Это обновление в VS Code позволяет отлаживать (искать ошибки в коде) с разными версиями Python в одном проекте автоматически. Раньше приходилось вручную переключать интерпретаторы (версии Python) для каждого проекта — теперь отладчик сам берёт нужный из статус-бара. Python Environments Extension — это "умный менеджер" версий Python, который делает всё проще.
Представьте: у вас несколько проектов, как разные комнаты с разными инструментами (Python 3.10 для одного, 3.12 для другого). Отладчик теперь сам выбирает инструмент для нужной комнаты.
- Множественные интерпретаторы в проекте: Открываете workspace с папками "Проект1" (Python 3.11) и "Проект2" (Python 3.12) — в статус-баре видно текущий. Отладчик использует именно его. Пример: В "Проект1" отлаживаете веб-скрипт на старом Python, в "Проект2" — ИИ на новом, без путаницы.
- Включение функции: Настройки VS Code (Ctrl + ,) → найдите python.useEnvironmentsExtension → поставьте true. Установите расширение Python Environments, если нет. Пример: Было: вручную меняли путь в launch.json. Стало: жмёте F5 — берётся Python из статус-бара автоматически.
- Преимущества для работы: Нет ошибок "не тот Python", быстрее переключение между проектами. Работает с venv, conda, pyenv. Пример до/после:
# Проект1 (.venv с Python 3.11) — отладка видит: Python 3.11
def calc(): pass # F5 → отладка на 3.11
# Проект2 (conda с Python 3.12) — отладка видит: Python 3.12
def ai_model(): pass # F5 → отладка на 3.12
Автоматически после обновления Python-расширения. Если проблемы — проверьте статус-бар внизу VS Code.
Другие изменения и улучшения.
Мы также добавили небольшие улучшения и исправили проблемы, запрошенные пользователями, которые должны улучшить ваш опыт работы с Python в Visual Studio Code. Среди заметных изменений:
- Расширение Python Environments теперь учитывает существующую пользовательскую настройку python.poetryPath для указания используемого исполняемого файла Poetry (vscode-python-environments#918)
- Расширение Python Environments теперь обнаруживает файлы requirements.txt и dev-requirements.txt при создании нового виртуального окружения для автоматической установки зависимостей (vscode-python-environments#506)
Мы также хотели бы выразить особую благодарность этому месяцу внесшим вклад:
@iBug: Исправил дрейф курсора в Python REPL в vscode-python#25521
Попробуйте эти новые улучшения, скачав расширение Python из Marketplace или установив их напрямую из вида расширений в Visual Studio Code (Ctrl + Shift + X или ⌘ + ⇧ + X). Подробнее о поддержке Python в Visual Studio Code можно узнать в документации. Если возникнут проблемы или предложения, пожалуйста, создайте issue на странице GitHub Python VS Code.
Это список мелких, но полезных исправлений и улучшений в обновлении Python-расширения для VS Code. Представьте: разработчики собрали жалобы пользователей и починили "мелочи", которые раздражали при работе. Ничего революционного, но кодить стало удобнее и стабильнее. Python Environments — это менеджер виртуальных окружений (отдельные "песочницы" для проектов).
- Исправление зависания PowerShell
Убрали тормоза при запуске команд в PowerShell (популярная оболочка Windows). Теперь активация расширений быстрая.
Пример: Открываете VS Code — раньше ждали 10 сек, теперь мгновенно. - Поддержка пути к Poetry
Если используете Poetry (менеджер пакетов/окружений), можно указать свой путь к нему в настройках.
Пример: У вас Poetry в C:\Tools\poetry.exe — пишете python.poetryPath: "C:\\Tools\\poetry.exe" и всё работает без поиска. - Автоустановка из requirements.txt и dev-requirements.txt
При создании venv расширение само находит файлы зависимостей (основные и для разработки) и ставит пакеты.
Пример: Создаёте окружение — автоматически ставит numpy из requirements.txt и pytest из dev-requirements.txt. Не копируйте вручную! - Благодарность контрибьютору
Пользователь @iBug починил "прыгающий курсор" в интерактивной консоли Python (REPL).
Пример: Пишете print(1) в консоли — курсор больше не улетает влево.
Обновляйте расширение в VS Code (Ctrl+Shift+X). Всё бесплатно, работает сразу.
https://devblogs.microsoft.com/python/python-in-visual-studio-code-november-2025-release/
#Python #VisualStudioCode #VSCode #Pylance #Copilot #Docstring #WildcardImports #Debugging #PythonEnvironments #АгрКронанейтрисОррпидиа
«Magis complicated, in dulcius»