Настройка Visual Studio 2022 для работы с Python

#18  пятница, 14 июня 2024 г.  10 минут(ы)  944 слова

Запустите Visual Studio 2022 и выберите "Create a new project". В поиске шаблонов проектов введите "Python", выберите "Python Application" и нажмите "Next". Укажите имя и расположение проекта, а затем нажмите "Create".

Настройка виртуальной среды Python в Visual Studio 2022

Рекомендуется использовать виртуальную среду для изоляции зависимостей вашего проекта. В окне "Solution Explorer" найдите "Python Environments", щелкните правой кнопкой мыши по "Python Environments", выберите "Add Environments".

Python Add Environments

Назовите среду в поле Name как .env, которая будет добавлена в корневой каталог вашего проекта. Наличие виртуальной среды .env по умолчанию для всех проектов удобно для добавления в .gitignore

Также выберите версию Python которую хотите использовать с проектом в поле "Base Interpreter", например "Python 3.11(64-bit)".

Python .env Environment

Чтобы активировать созданную виртуальную среду в окне "Solution Explorer" выберите нужную вам виртуальную среду из списка "Python Environments". Щелкните правой кнопкой мыши на выбранной среде и выберите "Activate Environment" из контекстного меню.

Создайте файл requirements.txt в корневой директории вашего проекта. Файл requirements.txt используется для указания зависимостей вашего проекта. Каждая зависимость указывается в отдельной строке в формате <название пакета>==<версия>. Например:

requests==2.25.1
numpy==1.19.5

Это можно также сделать для уже установленных модулей в виртуальную среду .env, если выбрвть в "Python Environments", виртуальную среду ".env" и правой кнопкой мыши, выберите "Generate requirements.txt".

requirements.txt

Установить зависимости из requirements.txt в вашу виртуальную среду можно выбрав в "Python Environments", виртуальную среду ".env" и правой кнопкой мыши, выберите "Install from requirements.txt"

requirements.txt

В Visual Studio 2022, вы можете установить пакеты Python прямо из пользовательского интерфейса. В Solution Explorer выберите "Python Environments" и щелкните правой кнопкой мыши, затем выберите "Manage Python Packages..."

requirements.txt

В открывшемся окне "Python Environments" перейдите на вкладку "Packages (PyPI)". В поле "Search PyPI and installed packages" (Поиск в PyPI и установленные пакеты) введите имя пакета, который вы хотите установить, и нажмите Enter. Если пакет будет найден то ниже нажмите на "Run command: pip install <имя пакета>" Если нет то в списке результатов найдите нужный пакет и щелкните по нему. Нажмите кнопку "Install" (Установить).

requirements.txt

Терминал в Visual Studio для работы с Python

Откройте терминал в Visual Studio (View -> Terminal), или используйте внешний терминал, и перейдите в корневую директорию вашего проекта.

Тут так же можно создать виртуальную среду Python с помощью инструмента venv. Выполните следующую команду в терминале:

python -m venv .env

Тут так же можно установите зависимости из requirements.txt в вашу виртуальную среду. Выполните следующую команду:

pip install -r requirements.txt

Для работы с вашим проектом потребуется активировать виртуальную среду в команндной строек Windows или во внешнем терменале(который вы уже запускали выше) выполните скрипт activate.bat:

.\.env\Scripts\activate

Пример работы с вашим приложением на Python из виртуальной среды .env

Microsoft Windows [Version 10.0.19045.3086]
(c) Microsoft Corporation. All rights reserved.

C:\WINDOWS\system32>cd C:\projects\python\microweb\

C:\projects\python\microweb>.\.env\Scripts\activate

(.env) C:\projects\python\microweb>

(.env) C:\projects\python\microweb>python microweb.py
C:\projects\python\microweb
DONE!
Elapsed time:  1.16 seconds

(.env) C:\projects\python\microweb>

Сообщение об ошибке, с которым вы можете столкнуться:

.\.env\Scripts\activate : File .\.env\Scripts\Activate.ps1 cannot be loaded because running scripts is disabled on this system. For more information, see about_Execution_Policies at https:/go.microsoft.com/fwlink/?LinkID=135170.
At line:1 char:1
+ .\.env\Scripts\activate
+ ~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : SecurityError: (:) [], PSSecurityException
    + FullyQualifiedErrorId : UnauthorizedAccess

Указывает на то, что сценарий .env\Scripts\activate не может быть выполнен, поскольку сценарии PowerShell отключены в вашей системе. Чтобы решить эту проблему, вам нужно изменить политику выполнения с помощью команд PowerShell. Вот подробное объяснение того, как это сделать:

Как изменить политику выполнения скриптов в PowerShell

  1. Откройте PowerShell с административными правами:
  2. Нажмите клавишу Windows или кликните на иконку Windows на панели задач.
  3. Введите PowerShell в строку поиска.
  4. Щелкните правой кнопкой мыши по Windows PowerShell и выберите Запуск от имени администратора.

  5. Проверьте текущую политику выполнения:

  6. В окне PowerShell введите следующую команду и нажмите Enter:
Get-ExecutionPolicy -List
  • Эта команда отобразит список политик выполнения для разных областей (MachinePolicy, UserPolicy, Process, CurrentUser, LocalMachine).

  • Измените политику выполнения на "Unrestricted":

  • Введите следующую команду и нажмите Enter:
Set-ExecutionPolicy Unrestricted -Force
  • Команда изменит политику выполнения на "Unrestricted" и принудительно применит её, используя параметр -Force, поскольку для этой операции требуются права администратора.

  • Запустите скрипт активации:

  • Теперь вы можете выполнить скрипт активации, например:
.\env\Scripts\activate

Примечание: Изменение политики выполнения на "Unrestricted" может представлять потенциальную угрозу безопасности, поэтому используйте эту настройку с осторожностью и только если вы доверяете исполняемым скриптам.

Теперь вы можете работать с вашим проектом, используя активированную виртуальную среду Python в Visual Studio. Зависимости из requirements.txt будут доступны в вашем проекте.

Обратите внимание, что эти инструкции предполагают, что у вас уже установлен Python на вашей машине. Если Python не установлен, убедитесь, что вы установили его и добавили путь к исполняемому файлу Python.exe в переменную среды PATH.

Теперь у вас должна быть настроена виртуальная среда Python с использованием .env и requirements.txt в Visual Studio. Вы можете продолжать разрабатывать ваш проект с учетом этих настроек.

Установить как точку входа Python-файл в Visual Studio 2022

Чтобы выбрать Python-файл, который будет запускаться по умолчанию в Visual Studio 2022, выполните следующие шаги:

Откройте ваш проект в Visual Studio 2022.

В обозревателе решений Solution Explorer найдите Python-файл, который вы хотите установить как файл, запускающийся по умолчанию.

Щелкните правой кнопкой мыши на этом Python-файле и выберите "Установить как точку входа" (Set as Startup File) из контекстного меню.

Python Set as Startup File

Теперь в Solution Explorer этот файл будет выделен жирным шрифтом показывающим что является файлом, запускающимся по умолчанию.

Теперь, когда вы запускаете ваш проект, Visual Studio будет использовать выбранный Python-файл как точку входа.

Если вы хотите изменить файл, запускающийся по умолчанию, на другой Python-файл, просто щелкните правой кнопкой мыши на новом файле и выберите "Установить как точку входа" (Set as Startup File). Таким образом, Visual Studio будет использовать новый Python-файл как точку входа при запуске проекта.