Поделиться через


Краткое руководство. Открытие и запуск кода Python в папке в Visual Studio

В этом кратком руководстве описано, как запустить код Python в Visual Studio 2019 и более поздних версиях, не создавая проект Visual Studio. Visual Studio упрощает открытие и запуск существующего кода Python из папки. Те же функции и команды доступны для разработки кода Python, как при выборе работы с проектом.

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

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

  • Инструкции, описанные в этом кратком руководстве, применяются к любой папке с кодом Python. Чтобы следовать примеру, описанному в этой статье, клонируйте gregmalcolm/python_koans репозиторий GitHub на компьютер с помощью следующей команды:

    git clone https://github.com/gregmalcolm/python_koans
    

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

Открытие локальной папки кода

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

  1. Запустите Visual Studio. В окне запуска выберите "Открыть локальную папку " в столбце "Начало работы ".

    Снимок экрана: выбор параметра

    Снимок экрана: выбор параметра

    Если вы используете python_koans пример кода репозитория, обязательно выберите папку Python3 в папке клонирования.

    Если Visual Studio уже запущен, вместо этого можно выбрать папку "Открыть>файл".>

  2. Перейдите к папке, содержащей код Python, и выберите " Выбрать папку":

    Снимок экрана: выбор локальной папки с существующим кодом Python в Visual Studio 2022.

    Снимок экрана: выбор локальной папки с существующим кодом Python в Visual Studio.

  3. Visual Studio отображает файлы в Обозреватель решений в представлении папок. Вы можете развернуть и свернуть папку с помощью стрелки слева от имени папки:

    Снимок экрана: стрелки развертывания и свернуть папки в Обозреватель решений в Visual Studio 2022.

    Снимок экрана: стрелки развертывания и свертывание папок в Обозреватель решений в Visual Studio.

  4. При открытии папки Python Visual Studio создает несколько скрытых папок для управления параметрами, связанными с программой. Чтобы просмотреть эти папки (и другие скрытые файлы и папки, например папку .git ), выберите параметр "Показать все файлы" :

    Снимок экрана: просмотр скрытых папок и файлов в Обозреватель решений в Visual Studio 2022.

    Снимок экрана: просмотр скрытых папок и файлов в Обозреватель решений в Visual Studio.

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

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

  1. В Обозреватель решений щелкните правой кнопкой мыши файл contemplate-koans.py и выберите "Задать в качестве элемента запуска":

    Снимок экрана, на котором показано, как настроить файл koans Python в качестве элемента запуска в Обозреватель решений в Visual Studio 2022.

    Снимок экрана: настройка файла Koans Python в качестве элемента запуска в Обозреватель решений в Visual Studio.

    Внимание

    Если элемент запуска не расположен в корне открываемой папки, необходимо также добавить строку в JSON-файл конфигурации запуска, как описано в рабочем каталоге Set.

  2. Запустите код, выбрав "Начать отладку>" без отладки или используйте сочетание клавиш CTRL+F5. Вы также можете выбрать сплошную стрелку воспроизведения рядом с именем элемента запуска на панели инструментов Visual Studio. Этот параметр запускает код в отладчике Visual Studio.

    Для всех этих методов запуска Visual Studio обнаруживает, что элемент запуска является файлом Python и автоматически запускает код в среде Python по умолчанию. Текущая среда отображается справа от имени элемента запуска на панели инструментов. В следующем примере текущая среда — Python 3.11 (64-разрядная версия):

    Снимок экрана: запуск программы с отладкой с помощью сплошной стрелки воспроизведения на панели инструментов Visual Studio 2022.

    Для всех этих методов запуска Visual Studio обнаруживает, что элемент запуска является файлом Python и автоматически запускает код в среде Python по умолчанию. Текущая среда отображается справа от имени элемента запуска на панели инструментов. В следующем примере текущая среда — Python 3.6 (32-разрядная версия):

    Снимок экрана: запуск программы с отладкой с помощью сплошной стрелки воспроизведения в Visual Studio.

    Если на панели инструментов не отображается текущая среда Python, выберите "Просмотреть>другие среды> Python".

  3. При запуске программы Visual Studio открывает окно командной строки для отображения выходных данных программы:

    Снимок экрана: окно вывода, которое откроется Visual Studio 2022 для выходных данных программы из работающего кода Python.

    Снимок экрана: окно вывода, которое Откроется Visual Studio для вывода программы из работающего кода Python.

    Примечание.

    Если вы запускаете python-koans программу с отладкой, необходимо изменить значения в коде для завершения выполнения программы.

  4. Код можно запустить в другой среде Python:

    1. Разверните текущий раскрывающийся список среды Python на панели инструментов Visual Studio и выберите нужную среду.

    2. Перезапустите программу.

  5. Когда вы будете готовы закрыть папку кода в Visual Studio, выберите папку "Закрыть файл>".

Настройка рабочего каталога

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

Предположим, что вы открываете корневую папку репозитория и видите вложенную папку python_koans Python3, содержащую файл Python с именем contemplate-koans.py. Вы решили задать файл python3/contemplate-koans.py в качестве файла запуска. При запуске кода отображается сообщение об ошибке, в которую не удается найти файл с именем koans.txt . Ошибка возникает из-за того, что файл contemplate-koans.py ожидает, что Python будет выполняться в папке Python3, а не корневом каталоге репозитория.

В таком случае следует добавить в JSON-файл конфигурации запуска дополнительную строку, которая указывает рабочий каталог:

  1. В Обозреватель решений щелкните правой кнопкой мыши файл запуска Python (.py) и выберите команду Добавить конфигурацию отладки:

    Снимок экрана: выбор параметра

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

    Снимок экрана: выбор отладчика по умолчанию в диалоговом окне

    Примечание.

    Если параметр по умолчанию не отображается в качестве параметра, при выборе команды "Добавить конфигурацию отладки" выберите файл Python .py. В Visual Studio тип файла определяет отображаемые варианты действий в отладчике.

  3. Visual Studio откроет файл с именем launch.vs.json, расположенный в скрытой папке .vs. Этот файл описывает контекст отладки для проекта. Чтобы указать рабочий каталог, добавьте значение для "workingDirectory" свойства. python-koans Например, можно добавить свойство и значение: "workingDirectory": "python3"

    {
      "version": "0.2.1",
      "defaults": {},
      "configurations": [
        {
          "type": "python",
          "interpreter": "(default)",
          "interpreterArguments": "",
          "scriptArguments": "",
          "env": {},
          "nativeDebug": false,
          "webBrowserUrl": "",
          "project": "contemplate_koans.py",
          "projectTarget": "",
          "name": "contemplate_koans.py",
          "workingDirectory": "python3"
        }
      ]
    }
    
  4. Сохраните изменения в файле launch.vs.json .

  5. Снова выполните программу. Теперь выполнение кода должно выполняться в указанной папке.

  1. В Обозреватель решений щелкните правой кнопкой мыши файл запуска Python (.py) и выберите отладку и запуск Параметры:

    Снимок экрана: выбор параметра

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

    Снимок экрана: выбор отладчика по умолчанию в диалоговом окне

    Примечание.

    Если параметр по умолчанию не отображается, обязательно выберите файл Python .py при выборе команды "Отладка и запуск Параметры". В Visual Studio тип файла определяет отображаемые варианты действий в отладчике.

  3. Visual Studio откроет файл с именем launch.vs.json, расположенный в скрытой папке .vs. Этот файл описывает контекст отладки для проекта. Чтобы указать рабочий каталог, добавьте значение для "workingDirectory" свойства. python-koans Например, можно добавить свойство и значение: "workingDirectory": "python3"

    {
      "version": "0.2.1",
      "defaults": {},
      "configurations": [
        {
          "type": "python",
          "interpreter": "(default)",
          "interpreterArguments": "",
          "scriptArguments": "",
          "env": {},
          "nativeDebug": false,
          "webBrowserUrl": "",
          "project": "contemplate_koans.py",
          "projectTarget": "",
          "name": "contemplate_koans.py",
          "workingDirectory": "python3"
        }
      ]
    }
    
  4. Сохраните изменения в файле launch.vs.json .

  5. Снова выполните программу. Теперь выполнение кода должно выполняться в указанной папке.