Использование папок Python в путях поиска Visual Studio

В обычной программе PYTHONPATH Python переменная среды (или IRONPYTHONPATHт. д.) предоставляет путь поиска по умолчанию для файлов модулей. Инструкции from <name> import... или import <name> инструкции python позволяют искать определенные расположения для файлов, которые соответствуют указанному.<name> Расположения выполняются в следующем порядке:

  1. Встроенные модули Python
  2. Папка, содержащая текущий код Python
  3. "Путь поиска модуля", определенный применимой переменной среды (Дополнительные сведения см . в разделе "Путь поиска модуля" и " Среда" в основной документации по Python).)

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

  • Ожидают ли указанные модули установки Python 2.7, Python 3.6 или другой версии?
  • Должны ли файлы, найденные в переменной среды поиска, переопределить модули стандартной библиотеки?
  • Ожидается ли любое переопределение и решение или может ли действие быть вредоносным?

Чтобы помочь разработчикам, Visual Studio предоставляет способ указания путей поиска непосредственно в средах и проектах Python. Код, который выполняется или отлаживать в Visual Studio, получает пути поиска из переменной PYTHONPATH среды и эквивалентной переменной. Добавив пути поиска, Visual Studio проверяет библиотеки в указанных расположениях и создает базы данных IntelliSense для библиотек по мере необходимости. (В Visual Studio 2017 версии 15.5 и более ранних версиях создание базы данных может занять некоторое время в зависимости от количества библиотек).

Необходимые компоненты

  • Visual Studio. Чтобы установить продукт, выполните действия, описанные в разделе "Установка Visual Studio".

  • Папки Python, которые необходимо добавить в пути поиска.

Добавление папок Python в пути поиска

Выполните следующие действия, чтобы добавить папку Python в пути поиска Visual Studio:

  1. В Обозреватель решений разверните узел проекта Python, щелкните правой кнопкой мыши пути поиска и выберите "Добавить папку в путь поиска":

    Снимок экрана, на котором показано, как получить доступ к команде

  2. В диалоговом окне перейдите к расположению папки, которую нужно добавить в распознанные пути поиска.

  3. Выберите папку и нажмите кнопку "Выбрать папку".

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

Примечание.

Если среда основана на Python 3 и пытаетесь добавить путь поиска к модулям Python 2.7, могут появиться ошибки.

Добавление ZIP-файлов и яйцо в пути поиска

Файлы с расширением можно .egg добавить в пути поиска с .zipпомощью параметра "Добавить ZIP-архив" в путь поиска. Как и при использовании папок, содержимое этих файлов проверяется и предоставляется для IntelliSense.