Параметры для Python в Visual Studio

Visual Studio поддерживает настройку интерактивной среды разработки (IDE) для разработки Python. Параметры можно задать в соответствии с вашими предпочтениями и соответствовать конкретным потребностям среды разработки. В этой статье описываются параметры, доступные для общего макета и поведения, отладки, диагностика и расширенных возможностей языка Python.

Расположение параметров Python

Параметры конфигурации Python доступны на панели инструментов Visual Studio в разделе "Параметры инструментов>". В диалоговом окне "Параметры" перечислены большинство параметров Python на вкладке Python :

Вы можете настроить настройки для отладки, анализа сервера языка Pylance, сред conda, общей среды и Интерактивной Windows.

В диалоговом окне "Параметры" перечислены другие параметры Python в текстовом редакторе>Python. Существуют параметры для полос прокрутки, вкладок и форматирования, а также общих и расширенных параметров. Другие параметры доступны в разделе "Шрифты и цвета среды>" для группы параметров текстового редактора.

Примечание.

Диалоговое окно "Параметры" может включать экспериментальную вкладку или группу для функций, которые не описаны в этой статье. Дополнительные сведения см. в записях в блоге Майкрософт по проектированию Python.

Конкретные параметры для Python

В разделе "Параметры>Python">можно задать параметры python для общей среды, включая интерактивные среды Windows, среды conda, отладку и многое другое.

Общие параметры Python

В разделе >"Параметры>Python>" доступны следующие параметры:

Вариант	По умолчанию.	Description
Показывать окно вывода при создании виртуальных окружений	Вкл	Снимите флажок, чтобы предотвратить появление окна вывода.
Показывать окно вывода при установке или удалении пакетов	Вкл	Снимите флажок, чтобы предотвратить появление окна вывода.
Show notifications bar to create environments (Показать панель уведомлений для создания окружений)	Вкл	При установке и открытии проекта с файлом requirements.txt или environment.yml Visual Studio отображает информационную панель с предложениями по созданию виртуальной среды или среды conda, соответственно, вместо использования глобальной среды по умолчанию.
Показать панель уведомлений для установки пакетов	Вкл	При установке и открытии проекта с requirements.txt-файлом, который не использует глобальную среду по умолчанию), Visual Studio сравнивает эти требования с пакетами, установленными в текущей среде. Если отсутствуют какие-либо пакеты, Visual Studio отображает запрос на установку зависимостей.
Отображение панели уведомлений для настройки тестовой платформы	Вкл	Если visual Studio обнаруживает файлы в проекте Python, которые могут содержать тесты, но не включена тестовая платформа, Visual Studio предложит включить pytest или unittest.
Всегда запускать диспетчеры пакетов от имени администратора	Выключено	Всегда повышает уровень прав для pip install и аналогичных операций диспетчера пакетов для всех окружений. При установке пакетов Visual Studio запрашивает права администратора, если среда находится в защищенной области файловой системы, например c:\Program Files. В этом запросе можно указать, что следует всегда повышать уровень прав для команды установки только для этого конкретного окружения. Дополнительные сведения см. на вкладке "Пакеты".

Параметры среды Conda

В разделе >"Параметры>Python Conda>" доступны следующие параметры:

Вариант	По умолчанию.	Description
Путь к исполняемому файлу Conda	(пусто)	Указывает точный путь к исполняемому файлу conda.exe вместо того, чтобы полагаться на установку Miniconda по умолчанию, включенную в рабочую нагрузку Python. Если здесь указан другой путь, он имеет приоритет над стандартной установкой и любыми исполняемыми файлами conda.exe, которые указаны в реестре. Этот параметр может потребоваться, если вы вручную установите более новую версию Anaconda или Miniconda или решите применить 32-разрядный дистрибутив вместо стандартного 64-разрядного.

Варианты для отладки

В разделе >"Параметры>Python" доступны следующие параметры отладки Python:>

Вариант	По умолчанию.	Description
Запрашивать перед запуском, если есть ошибки	Вкл	Если этот параметр задан, Visual Studio предложит подтвердить, что вы хотите запустить код с ошибками. Чтобы отключить предупреждение, снимите этот параметр.
Ожидать входные данные при ненормальном завершении работы процесса Ожидать входные данные при нормальном завершении работы процесса	Включено (для обоих)	Программа Python, запущенная из Visual Studio, выполняется в собственном окне консоли. По умолчанию, каким бы образом работа программы ни завершилась, это окно ожидает нажатие вами клавиши, прежде чем закрыться. Чтобы убрать этот запрос и закрывать окно автоматически, снимите один или оба этих флажка.
Дублировать вывод программы в окно вывода отладки	Вкл	Отображает выходные данные программы как в отдельном окне консоли, так и в окне вывода Visual Studio. Снимите этот флажок, чтобы отображать выходные данные только в отдельном окне консоли.
Прерывать при исключении SystemExit с нулевым кодом выхода	Выключено	Если флажок установлен, отладчик останавливается на этом исключении. Если флажок снят, отладчик завершает работу, не прерывая выполнение.
Включить отладку стандартной библиотеки Python	Выключено	Позволяет выполнить по шагам исходный код стандартной библиотеки во время отладки, однако увеличивает время запуска отладчика.
Показать возвращаемое функцией значение	Вкл	Отображает возвращаемые значения функции в окне Локальные, а затем выполняет в отладчике шаг с обходом функции (F10).
Отображение переменных	Вкл	Отображает четыре группы переменных для отображения и форматирования отображения (группирование, скрытие, встроенное). - Класс: по умолчанию используется "Группа" - Защищенный: по умолчанию используется inline" - Функция: по умолчанию используется "Группа" - Специальное: по умолчанию используется "Группа"

Параметры анализа

В разделе >"Параметры>Python>" доступны следующие параметры:

Вариант	По умолчанию.	Description
Режим диагностики	Только открытые файлы	Указывает, какие файлы кода анализирует сервер языка для проблем, включая только рабочие области и открытые файлы.
Уровень журнала	Информация	Указывает уровень ведения журнала, выполняемый сервером языка. Возможные уровни ведения журнала, повышающие уровень предоставленной информации, включают в себя ошибки, предупреждение, сведения и трассировку.
Проверка типа	Выключено	Указывает уровень проверка анализа типа для выполнения: - Выкл. Создание неразрешенных импортов и переменных диагностика, но не проводите анализ типа проверка - Базовый: используйте нетиповые (все правила на уровне off) и базовые правила проверка связанных с ним типов - Строго: используйте все правила проверка типа при наибольшей серьезности ошибки, включая все правила в соответствии с уровнями off и Basic.
Формат импорта	Абсолютный	Определяет формат по умолчанию при автоматическом импорте модулей, включая абсолютный или относительный.
Заглушки путь	<Пусто>	Указывает путь к каталогу, который содержит заглушки пользовательского типа. Ожидается, что файлы заглушки типов для каждого пакета будут находиться в отдельном подкаталоге.
Пути поиска	<Пусто>	Задает пути поиска для разрешения импорта. Принимает пути, указанные как строки и разделенные запятыми, если существует несколько путей, например ["path 1","path 2"].
Типы путей	<Пусто>	Указывает пути для Visual Studio для использования пользовательских типов файлов вместо его пакетной версии.
Автоматическое добавление общих путей поиска, таких как src	Вкл	Указывает, следует ли автоматически добавлять пути поиска на основе предопределенных имен, например src.
Индекс установил сторонние библиотеки и файлы пользователей для языковых функций, таких как авто импорт, добавление импорта, символов рабочей области и т. д.	Выключено	Указывает, должен ли сервер языка индексировать пользовательские файлы и устанавливать сторонние библиотеки при запуске. Индекс предоставляет более полный набор символов в функциях, включая автоматический импорт, быстрые исправления, автозавершения и т. д. — При установке Visual Studio индексирует символы верхнего уровня установленных пакетов, такие как символы в пакетеили __init__.py, а также все символы от 2000 пользовательских файлов. — Если не задано, Visual Studio отображает символы, на которые ссылаются или используются файлы, ранее открытые в редакторе или загруженные в нее.

Параметры интерактивных окон

Следующие параметры доступны в разделе >"Параметры>Python>Interactive Windows":

Вариант	По умолчанию.	Description
Сценарии	Н/Д	Указывает общую папку для скриптов запуска, применяемых к интерактивному Windows для всех сред. Дополнительные сведения см. в разделе "Скрипты запуска". Примечание. Эта функция может не работать в вашей версии Visual Studio.
Использовать стрелки "вверх" и "вниз" для навигации по журналу	Вкл	Позволяет использовать клавиши со стрелками для перемещения по журналу в интерактивном окне. Снимите этот флажок, чтобы использовать клавиши со стрелками для перемещения по выходным данным интерактивного окна.
Режим завершения	Вычислять только выражения без вызовов функций	Процесс определения доступных элементов в выражении в интерактивном окне может потребовать вычисления текущего незавершенного выражения, что может привести к побочным эффектам или функциям, вызывающимся несколько раз. Значение по умолчанию Вычислять только выражения без вызовов функций исключает выражения, которые распознаются как вызывающие функцию, но вычисляет другие выражения. Например, он вычисляет оператор a.b , но не a().b оператор. Значение Никогда не вычислять выражения устраняет все побочные эффекты, используя только нормальную подсистему IntelliSense для предложений. При выборе значения Вычислять все выражения выражение вычисляется полностью, чтобы получить предложения независимо от наличия побочных эффектов.
Скрывать предложения статического анализа	Выключено	Когда параметр задан, отображаются только предложения, получаемые путем вычисления выражения. Если используется совместно с режимом завершенияНикогда не вычислять выражения, в интерактивном окне не отображается никаких полезных завершений.

Параметры текстового редактора для Python

В разделе "Текстовый редактор>Python" доступны параметры полосы прокрутки, вкладок и форматирования, а также общие и дополнительные параметры:

Общие параметры редактора Python

Следующие параметры доступны в разделе "Параметры>текстового редактора>Python>":>

Вариант	По умолчанию.	Description
Автоматически отображать список членов	Вкл	Установите этот параметр для автоматического перечисления членов для завершения инструкций кода.
Скрывать дополнительные члены	Вкл	Если включен параметр "Автоматический список элементов ", установите этот параметр, чтобы скрыть расширенные члены из предложений завершения. Расширенные члены — это члены, которые используются реже, чем другие.
Сведения о параметрах	Вкл	При наведении указателя мыши на параметры отображаются подробные сведения, такие как определение элемента и ссылки на документацию.
Включить виртуальное пространство	Вкл	При установке вставляет пробелы в конец каждой строки кода. Этот параметр позволяет помещать комментарии на одинаковом расстоянии от кода. Режим виртуального пространства включен в режиме выбора столбцов. Если режим виртуального пространства не включен, точка вставки перемещается от конца одной строки непосредственно к первому символу следующей строки. Примечание. Этот параметр зависит от общего параметра "Текстовый редактор>">,>чтобы включить глобальное пространство виртуального пространства. Если глобальный параметр не включен, этот параметр нельзя включить на уровне языка.
Переносить по словам	Выключено	Задайте этот параметр, чтобы разрешить длинные строки кода упаковывать на основе ширины окна просмотра редакторов.
Показывать визуальные глифы для переноса по словам	Выключено	Если включен параметр оболочки Word, установите этот параметр для отображения визуальных глифов.
Номера строк	Выключено	Задайте этот параметр, чтобы отобразить номера строк в левом поле редактора для каждой строки кода.
Открывать URL-адреса однократным щелчком	Вкл	При установке можно щелкнуть URL-адрес, чтобы перейти к целевому расположению.
Панель навигации	Выключено	Установите этот параметр, чтобы включить раскрывающийся список в верхней части окна кода. Эти поля помогают перейти к коду в базе кода, в которой можно выбрать тип или член, к которому можно перейти напрямую. Примечание. Этот параметр зависит от глобального параметра панели навигации в текстовом редакторе>всех языков.>> Дополнительные сведения см. в строке навигации по коду> навигации.
Автоматическое завершение фигурных скобок	Вкл	При установке Visual Studio автоматически добавляет закрывающую скобку для любой открытой фигурной скобки при вводе кода.
Применение вырезанного или копирования к пустым строкам при отсутствии выделения	Вкл	По умолчанию Visual Studio вырезает или копирует всю строку кода, если явного выделения нет. Используйте этот параметр, чтобы включить или отключить это поведение "Вырезать" или "Копировать" при вызове пустых строк.

Дополнительные сведения см. в диалоговом окне "Параметры": "Общие текстовые редакторы>".

Дополнительные параметры редактора Python

В разделе "Параметры>текстового редактора>инструментов>">доступны следующие параметры: "Дополнительно".

Вариант	По умолчанию.	Description
Предложение авто импорта завершений	Вкл	При установке Visual Studio предлагает автоматический импорт в завершениях.
Автоматическое добавление квадратных скобок для функций	Выключено	При установке Visual Studio автоматически добавляет скобки для функций при вводе кода в редакторе.

Параметр "Шрифты и цвета"

Другие параметры Python доступны в разделе "Шрифты среды>" и "Цвета", если для группы текстовых редакторов задано значение Python:

Все имена параметров Python содержат префикс Python и не нуждаются в пояснениях. Шрифт по умолчанию для всех цветовых тем Visual Studio — Consolas (обычный), 10 пунктов (не полужирный). Цвета по умолчанию зависят от темы. Как правило, вы изменяете шрифт или цвет, чтобы упростить чтение текста.