Краткое руководство. Клонирование репозитория с кодом Python в Visual Studio

В этом кратком руководстве описано, как клонировать репозиторий кода Python GitHub и создать проект. Visual Studio упрощает работу с проектами Python с помощью команд Git для доступа к содержимому под управлением версиями. Вы также можете клонировать репозитории кода Python из командной строки, а затем работать с проектами в Visual Studio.

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

• Visual Studio 2022, установленная с поддержкой рабочих нагрузок Python. Visual Studio 2022 обеспечивает простую интеграцию с GitHub с поддержкой команд Git. Дополнительные сведения см. в статье "Установка поддержки Python в Visual Studio".

Visual Studio для Mac не поддерживается. Дополнительные сведения см. в статье "Что происходит с Visual Studio для Mac?" Visual Studio Code в Windows, Mac и Linux хорошо работает с Python с помощью доступных расширений.

Клонирование существующих файлов репозитория

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

1. В Visual Studio выберите Git>Clone:

   

2. В диалоговом окне клонирования репозитория укажите репозиторий GitHub для клонирования:

   

   1. В качестве расположения репозитория введите URL-адрес репозитория для клонирования. В этом упражнении введите https://github.com/gregmalcolm/python_koans.

   2. В поле "Путь" введите папку в системе, в которой требуется, чтобы Visual Studio сохраняла клонированные файлы.

      Указанная папка должна быть точной папкой, которую вы хотите использовать Visual Studio. git clone В отличие от команды, при создании клона в Team Обозреватель Visual Studio не создает новую вложенную папку с именем репозитория.

   3. Когда вы будете готовы, нажмите кнопку "Клонировать".

   После завершения клонирования Visual Studio открывает область изменений Git для репозитория. Вы также можете увидеть папку с файлами клонированного репозитория в Обозреватель решений.

3. Выберите локальные репозитории Git>и убедитесь, что клонизированный репозиторий теперь находится в списке:

   

Внимание

В этом кратком руководстве вы создадите прямой клон репозитория python_koans на GitHub. Такой репозиторий защищен автором от непосредственного изменения, поэтому попытка зафиксировать в нем изменения завершится неудачей. На практике разработчики вместо этого создают вилку такого репозитория в собственной учетной записи GitHub, вносят в нее изменения, а затем создают запросы на вытягивание для отправки изменений в исходный репозиторий. При наличии собственной вилки укажите ее URL-адрес вместо URL-адреса исходного репозитория, который использовался ранее.

Создание проекта из клонированных файлов

После клонирования репозитория можно создать проект из клонированных файлов.

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

Внимание

Следующий процесс не перемещает и не копирует исходные исходные файлы. Если вы хотите работать с копией файлов, сначала дублируйте папку, а затем создайте проект.

1. Запустите Visual Studio и выберите Файл>Создать>Проект.

2. В диалоговом окне "Создание проекта" найдите python и выберите шаблон существующего кода Python и нажмите кнопку "Далее".

3. В диалоговом окне "Настройка нового проекта" введите имя и расположение проекта, выберите решение для хранения проекта и нажмите кнопку "Создать".

4. В мастере создания проекта из существующего кода Python задайте путь к папке существующему коду, задайте фильтр для типов файлов и укажите необходимые пути поиска, а затем нажмите кнопку "Далее". Если вы не знаете пути поиска, оставьте поле пустым.

   

5. На следующей странице выберите файл запуска проекта. Visual Studio выбирает глобальный интерпретатор Python по умолчанию и версию. Вы можете изменить среду с помощью раскрывающегося меню. Затем нажмите кнопку Далее.

   Примечание.

   В диалоговом окне отображаются только файлы в корневой папке. Если нужный файл находится в вложенной папке, оставьте файл запуска пустым. Файл запуска можно задать в Обозреватель решений, как описано на следующем шаге.

   

6. Выберите расположение для хранения файла проекта ( pyproj-файл на диске). При необходимости можно также включить автоматическое обнаружение виртуальных сред и настроить проект для разных веб-платформ. Если вы не уверены в этих параметрах, оставьте поля, заданные по умолчанию.

   

7. Выберите Готово.

   Visual Studio создаст проект и откроет его в Обозревателе решений. Если вы хотите переместить pyproj-файл в другое расположение, выберите файл в Обозреватель решений, а затем нажмите кнопку "Сохранить файл>как" на панели инструментов. Это действие обновляет ссылки на файлы в проекте, но не перемещает файлы кода.

8. Чтобы задать другой файл запуска, найдите файл в Обозреватель решений, щелкните файл правой кнопкой мыши и выберите "Задать в качестве файла запуска".

Настройка свойств проекта

Чтобы запустить проект, необходимо определить рабочий каталог проекта и сообщить Visual Studio, какой файл следует использовать в качестве файла запуска.

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

1. В Обозреватель решений разверните узел проекта, щелкните правой кнопкой мыши файл contemplate_koans.py и выберите "Задать в качестве файла запуска". Это действие позволяет Visual Studio знать, какой файл следует использовать для запуска проекта.

2. На главной панели инструментов Visual Studio выберите "Свойства проекта>", чтобы открыть свойства проекта.

3. На вкладке "Общие " просмотрите значение рабочего каталога для проекта.

   По умолчанию Visual Studio задает рабочий каталог корневому каталогу проекта (.). Обратите внимание, что файл запуска не имеет определенного расположения папки.

   

   Клонированные код программы ищет файл с именем koans.txt в рабочем каталоге. Код ожидает, что каталог будет расположением папки, в котором вы поручили Visual Studio хранить клонированные файлы репозитория. Если оставить рабочий каталог корнем проекта (.), программа создает ошибки среды выполнения.

4. Задайте для рабочего каталога значение папки клонированного репозитория, напримерC:\Users\contoso\source\repos\Python-Koans.

   Совет

   Быстрый способ подтвердить расположение папки для клонированных файлов — проверка свойства клонированного файла в Обозреватель решений. Щелкните правой кнопкой мыши файл koans.txt и выберите "Свойства", чтобы открыть область сведений в Обозреватель решений. В области сведений обратите внимание, что расположение папки для файла отображается в свойстве Full path . Это значение можно вставить в поле "Рабочий каталог" на странице свойств проекта.

   

5. Сохраните изменения и закройте область свойств проекта.

Запуск программы Python

Теперь вы готовы попробовать запустить приложение для нового проекта:

1. Выберите "Начать отладку без отладки>" (или используйте сочетание клавиш CTRL+F5) для запуска программы.

   Если для файла koans.txt отображается ошибка среды выполнения FileNotFoundError, убедитесь, что рабочий каталог задан правильно, как описано в предыдущем разделе.

2. При успешном выполнении программы отображается ошибка утверждения в строке 17 файла проекта /koans/about_asserts.py:

   

   Ошибка утверждения является преднамеренной. Программа предназначена для обучения Python, исправляя все преднамеренные ошибки. Дополнительные сведения о программе можно найти в Ruby Koans, которая вдохновила Python Koans.

3. Выйти из программы.

4. В Обозреватель решений дважды щелкните файл /koans/about_asserts.py, чтобы открыть файл в редакторе:

   

   По умолчанию номера строк не отображаются в редакторе. Чтобы просмотреть номера строк, выберите "Параметры инструментов>", разверните раздел "Общие" в текстовом редакторе>Python>и выберите параметр "Номера строк":

   

5. Исправьте ошибку в файле /koans/about_asserts.py , изменив False аргумент строки 17 Trueна . Вот как должен выглядеть обновленный код:

   self.assertTrue(True) # This value should be True
   

6. Запустите программу еще раз.

   Если Visual Studio предупреждает об ошибках, ответьте на сообщение "Да ", чтобы продолжить выполнение кода. На этот раз программа проходит через первый проверка и останавливается на следующем коане. Вы можете продолжить исправление дальнейших ошибок и запустить программу, чтобы увидеть корректировки.

Связанный контент

• Клонирование репозитория Git в Visual Studio
• Создание репозитория Git из Visual Studio
• Руководство. Работа с Python в Visual Studio