Как установить библиотеку в Visual Studio Code

Обновлено: 21.11.2024

В этом руководстве вы используете Python 3 для создания простейшего приложения Python "Hello World" в Visual Studio Code. Используя расширение Python, вы превращаете VS Code в отличную облегченную среду разработки Python (в которой вы можете найти продуктивную альтернативу PyCharm).

Это руководство знакомит вас с VS Code как средой Python, в первую очередь с тем, как редактировать, запускать и отлаживать код, выполняя следующие задачи:

Написать, запустить и отладить приложение Python "Hello World"
Узнайте, как устанавливать пакеты, создавая виртуальные среды Python.
Напишите простой скрипт Python для построения графиков в VS Code.

Если у вас возникнут какие-либо проблемы, не стесняйтесь сообщить о проблеме для этого руководства в репозитории документации VS Code.

Предпосылки

Чтобы успешно пройти это руководство, вам необходимо сначала настроить среду разработки Python. В частности, для этого руководства требуется:

Код VS
Расширение VS Code Python
Питон 3

Установите код Visual Studio и расширение Python

Если вы еще этого не сделали, установите VS Code.

Затем установите расширение Python для VS Code из Visual Studio Marketplace. Дополнительные сведения об установке расширений см. в разделе Extension Marketplace. Расширение Python называется Python и публикуется Microsoft.

Установите интерпретатор Python

Вместе с расширением Python вам необходимо установить интерпретатор Python. Какой интерпретатор вы используете, зависит от ваших конкретных потребностей, но некоторые рекомендации приведены ниже.

Окна

Примечание. Если у вас нет прав администратора, вы можете установить Python в Windows с помощью Microsoft Store. В Microsoft Store можно установить Python 3.7, Python 3.8, Python 3.9 и Python 3.10. Имейте в виду, что у вас могут возникнуть проблемы совместимости с некоторыми пакетами, использующими этот метод.

macOS

Системная установка Python в macOS не поддерживается. Вместо этого рекомендуется установка через Homebrew. Чтобы установить Python с помощью Homebrew на macOS, используйте команду brew install python3 в командной строке терминала.

Примечание. В macOS убедитесь, что расположение вашей установки VS Code включено в переменную среды PATH. Дополнительные сведения см. в этих инструкциях по настройке.

Линукс

Встроенная установка Python 3 в Linux работает хорошо, но для установки других пакетов Python необходимо установить pip с помощью get-pip.py.

Другие варианты

Наука о данных. Если ваша основная цель использования Python — наука о данных, вы можете рассмотреть возможность загрузки с Anaconda. Anaconda предоставляет не только интерпретатор Python, но и множество полезных библиотек и инструментов для обработки данных.

Подсистема Windows для Linux. Если вы работаете в Windows и хотите использовать среду Linux для работы с Python, вам подойдет подсистема Windows для Linux (WSL). Если вы выберете этот вариант, вам также потребуется установить расширение Remote — WSL. Дополнительную информацию об использовании WSL с VS Code см. в разделе Удаленная разработка VS Code или попробуйте учебник Работа в WSL, в котором вы узнаете, как настроить WSL, установить Python и создать приложение Hello World, работающее в WSL.

Проверьте установку Python

Чтобы убедиться, что вы успешно установили Python на свой компьютер, выполните одну из следующих команд (в зависимости от вашей операционной системы):

Linux/macOS: откройте окно терминала и введите следующую команду:

Windows: откройте командную строку и выполните следующую команду:

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

Примечание. Вы можете использовать команду py -0 во встроенном терминале VS Code для просмотра версий Python, установленных на вашем компьютере. Интерпретатор по умолчанию отмечен звездочкой (*).

Запустите VS Code в папке проекта (рабочей области)

С помощью командной строки или терминала создайте пустую папку с именем "hello", перейдите в нее и откройте VS Code ( code ) в этой папке ( . ), введя следующие команды:

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

При запуске VS Code в папке эта папка становится вашей «рабочей областью». VS Code хранит настройки, относящиеся к этой рабочей области, в файле .vscode/settings.json, который отделен от пользовательских настроек, которые хранятся глобально.

Кроме того, вы можете запустить VS Code через пользовательский интерфейс операционной системы, а затем использовать "Файл" > "Открыть папку", чтобы открыть папку проекта.

Выберите интерпретатор Python

Python — это интерпретируемый язык, и для запуска кода Python и получения Python IntelliSense необходимо указать VS Code, какой интерпретатор использовать.

В VS Code выберите интерпретатор Python 3, открыв палитру команд ( ⇧⌘P (Windows, Linux Ctrl+Shift+P ) ), начните вводить команду Python: Select Interpreter для поиска, затем выберите команду. Вы также можете использовать параметр «Выбор среды Python» в строке состояния, если он доступен (он также может уже отображать выбранный интерпретатор):

Команда представляет список доступных интерпретаторов, которые VS Code может найти автоматически, включая виртуальные среды. Если вы не видите нужный интерпретатор, см. раздел Настройка сред Python.

Примечание. При использовании дистрибутива Anaconda правильный интерпретатор должен иметь суффикс ('base':conda) , например Python 3.7.3 64-bit ('base':conda) .

Выбор интерпретатора определяет, какой интерпретатор будет использоваться расширением Python для этой рабочей области.

Примечание. Если вы выбираете интерпретатор без открытой папки рабочей области, VS Code вместо этого устанавливает python.defaultInterpreterPath в пользовательской области, которая устанавливает интерпретатор по умолчанию для VS Code в целом. Пользовательская настройка гарантирует, что у вас всегда будет интерпретатор по умолчанию для проектов Python. Настройки рабочей области позволяют переопределить настройки пользователя.

Создайте файл исходного кода Python Hello World

На панели инструментов проводника выберите кнопку "Новый файл" в папке hello:

Назовите файл hello.py , и он автоматически откроется в редакторе:

Используя расширение файла .py, вы указываете VS Code интерпретировать этот файл как программу Python, чтобы он оценивал содержимое с расширением Python и выбранным интерпретатором.

Примечание. Панель инструментов File Explorer также позволяет создавать папки в рабочей области для лучшей организации кода. Вы можете использовать кнопку Новая папка, чтобы быстро создать папку.

Теперь, когда у вас есть файл кода в рабочей области, введите следующий исходный код в hello.py :

Когда вы начнете вводить print , обратите внимание, как IntelliSense представляет параметры автозаполнения.

IntelliSense и автодополнение работают со стандартными модулями Python, а также с другими пакетами, которые вы установили в среде выбранного интерпретатора Python. Он также предоставляет дополнения для методов, доступных для типов объектов. Например, поскольку переменная msg содержит строку, IntelliSense предоставляет строковые методы при вводе msg. :

Вы можете поэкспериментировать с IntelliSense еще немного, но затем отмените свои изменения, чтобы у вас была только переменная msg и вызов печати, и сохраните файл ( ⌘S (Windows, Linux Ctrl+S )).

Подробнее о редактировании, форматировании и рефакторинге см. в разделе Редактирование кода. Расширение Python также полностью поддерживает Linting.

Запустить Hello World

Запустить hello.py с Python очень просто. Просто нажмите кнопку «Запустить файл Python в терминале» в правом верхнем углу редактора.

Кнопка открывает панель терминала, в которой ваш интерпретатор Python автоматически активируется, а затем запускает python3 hello.py (macOS/Linux) или python hello.py (Windows):

Есть еще три способа запуска кода Python в VS Code:

Щелкните правой кнопкой мыши в любом месте окна редактора и выберите «Запустить файл Python в терминале» (файл будет сохранен автоматически):

Выберите одну или несколько строк, затем нажмите Shift+Enter или щелкните правой кнопкой мыши и выберите «Выполнить выделение/строку в терминале Python». Эта команда удобна для проверки только части файла.

В палитре команд ( ⇧⌘P (Windows, Linux Ctrl+Shift+P ) ) выберите команду Python: Start REPL, чтобы открыть терминал REPL для выбранного интерпретатора Python. В REPL вы можете вводить и запускать строки кода по одной.

Настройте и запустите отладчик

Теперь попробуем отладить нашу простую программу Hello World.

Сначала установите точку останова на строке 2 файла hello.py, поместив курсор на вызов печати и нажав F9 . В качестве альтернативы, просто щелкните в левом поле редактора рядом с номерами строк. Когда вы устанавливаете точку останова, в поле появляется красный кружок.

Затем, чтобы инициализировать отладчик, нажмите F5 . Поскольку вы впервые отлаживаете этот файл, в палитре команд откроется меню конфигурации, позволяющее выбрать тип конфигурации отладки для открытого файла.

Примечание. VS Code использует файлы JSON для всех своих различных конфигураций; launch.json — это стандартное имя файла, содержащего конфигурации отладки.

Эти различные конфигурации полностью описаны в разделе Конфигурации отладки; на данный момент просто выберите файл Python, который является конфигурацией, которая запускает текущий файл, отображаемый в редакторе, с использованием выбранного в данный момент интерпретатора Python.

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

Отладчик остановится на первой строке точки останова файла. Текущая строка обозначена желтой стрелкой на левом поле. Если вы посмотрите на окно «Локальные переменные» в этот момент, вы увидите, что теперь определенная переменная msg появляется на панели «Локальные».

Вверху появляется панель инструментов отладки со следующими командами слева направо: продолжить ( F5 ), перейти ( F10 ), войти внутрь ( F11 ), выйти ( ⇧ F11 (Windows, Linux Shift+F11 )) , перезапустить ( ⇧⌘F5 (Windows, Linux Ctrl+Shift+F5 ) ) и остановить ( ⇧F5 (Windows, Linux Shift+F5 ) ).

Строка состояния также меняет цвет (оранжевый во многих темах), указывая на то, что вы находитесь в режиме отладки. Консоль отладки Python также автоматически появляется на нижней правой панели, чтобы показать выполняемые команды и вывод программы.

Чтобы продолжить выполнение программы, выберите команду "Продолжить" на панели инструментов отладки ( F5 ). Отладчик доводит программу до конца.

Совет. Информацию об отладке также можно просмотреть, наведя указатель мыши на код, например на переменные. В случае msg при наведении курсора на переменную строка Hello world отображается в поле над переменной.

Вы также можете работать с переменными в консоли отладки (если вы ее не видите, выберите «Консоль отладки» в правом нижнем углу VS Code или выберите ее в меню .). Затем попробуйте ввести следующие строки: один за другим, по запросу > в нижней части консоли:

Снова нажмите синюю кнопку «Продолжить» на панели инструментов (или нажмите F5), чтобы запустить программу до конца. «Hello World» появляется в консоли отладки Python, если вы вернетесь к ней, и VS Code выйдет из режима отладки после завершения программы.

Если вы перезапустите отладчик, он снова остановится на первой точке останова.

Чтобы остановить выполнение программы до ее завершения, используйте кнопку остановки с красным квадратом на панели инструментов отладки ( ⇧F5 (Windows, Linux Shift+F5 ) ) или используйте команду меню "Выполнить" > "Остановить отладку".

Подробнее см. в разделе Конфигурации отладки, где есть примечания о том, как использовать определенный интерпретатор Python для отладки.

Совет: используйте Logpoints вместо операторов печати. Разработчики часто засоряют исходный код операторами печати, чтобы быстро проверять переменные, не обязательно просматривая каждую строку кода в отладчике. В VS Code вы можете вместо этого использовать Logpoints. Точка журнала похожа на точку останова, за исключением того, что она выводит сообщение на консоль и не останавливает программу. Дополнительные сведения см. в разделе Logpoints в основной статье об отладке VS Code.

Установить и использовать пакеты

Давайте теперь запустим более интересный пример.В Python пакеты — это то, как вы получаете любое количество полезных библиотек кода, обычно из PyPI. В этом примере вы используете пакеты matplotlib и numpy для создания графического графика, как это обычно делается в науке о данных. (Обратите внимание, что matplotlib не может отображать графики при работе в подсистеме Windows для Linux, поскольку в ней отсутствует необходимая поддержка пользовательского интерфейса.)

Вернитесь к представлению Explorer (самый верхний значок слева, который показывает файлы), создайте новый файл с именем standardplot.py и вставьте в него следующий исходный код:

Совет. Если вы введете приведенный выше код вручную, вы можете обнаружить, что автозаполнение меняет имена после ключевых слов as, когда вы нажимаете Enter в конце строки. Чтобы избежать этого, введите пробел, а затем Enter.

Затем попробуйте запустить файл в отладчике, используя конфигурацию "Python: текущий файл", как описано в предыдущем разделе.

Если вы не используете дистрибутив Anaconda или ранее не устанавливали пакет matplotlib, вы должны увидеть сообщение «ModuleNotFoundError: нет модуля с именем 'matplotlib'». Такое сообщение указывает на то, что требуемый пакет недоступен в вашей системе.

Чтобы установить пакет matplotlib (который также устанавливает numpy в качестве зависимости), остановите отладчик и используйте палитру команд для запуска терминала: Создать новый терминал ( ⌃⇧` (Windows, Linux Ctrl+Shift+` ) ). Эта команда открывает командную строку для выбранного интерпретатора.

Среди разработчиков Python рекомендуется избегать установки пакетов в глобальную среду интерпретатора. Вместо этого вы используете виртуальную среду для конкретного проекта, содержащую копию глобального интерпретатора. Как только вы активируете эту среду, все пакеты, которые вы затем установите, будут изолированы от других сред. Такая изоляция уменьшает многие сложности, которые могут возникнуть из-за конфликтующих версий пакетов. Чтобы создать виртуальную среду и установить необходимые пакеты, введите следующие команды в зависимости от вашей операционной системы:

Примечание. Дополнительные сведения о виртуальных средах см. в разделе Среды.

Создать и активировать виртуальную среду

Примечание. Когда вы создаете новую виртуальную среду, VS Code должен предложить вам установить ее по умолчанию для папки вашей рабочей области. Если выбрано, среда будет автоматически активирована при открытии нового терминала.

Для Windows

Если команда активации генерирует сообщение «Activate.ps1 не имеет цифровой подписи. Вы не можете запустить этот сценарий в текущей системе.», то вам необходимо временно изменить политику выполнения PowerShell, чтобы разрешить выполнение сценариев (см. О выполнении Политики в документации PowerShell):

Для macOS/Linux

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

Установите пакеты

Перезапустите программу сейчас (с отладчиком или без него), и через несколько секунд появится окно графика с выводом:

После завершения введите deactivate в окне терминала, чтобы деактивировать виртуальную среду.

Дополнительные примеры создания и активации виртуальной среды и установки пакетов см. в руководстве по Django и в руководстве по Flask.

Дальнейшие шаги

Вы можете настроить VS Code для использования любой установленной среды Python, включая виртуальную среду и среду conda. Вы также можете использовать отдельную среду для отладки. Подробную информацию см. в разделе Среды.

Чтобы научиться создавать веб-приложения с помощью фреймворков Django и Flask, см. следующие руководства:

В этом кратком сообщении я расскажу о шагах, которые вы можете выполнить, чтобы установить библиотеку Python с помощью pip через Терминал или Блокнот Jupyter в Visual Studio Code (VSCode) на компьютере с Windows.

Предварительные условия

Чтобы выполнить действия, описанные в этом сообщении блога, вам необходимо установить на свой компьютер с Windows следующее:

Visual Studio Code: инструкции по его установке можно найти здесь.
Расширение Python для Visual Studio Code: инструкции по его установке можно найти здесь.
Python Interpreter: инструкции по его установке можно найти здесь.

Установка библиотеки Python с помощью терминала в VSCode

1) Доступ к терминалу кода Visual Studio

Перейдите в меню "Терминал" и выберите "Новый терминал".

Откроется новое окно терминала (на основе PowerShell).

2) Импорт библиотеки Python

Выполните следующую команду, чтобы убедиться, что pip установлен на вашем компьютере.

Допустим, вы хотите установить библиотеку Pandas Python.
Выполните следующую команду

Библиотека Pandas теперь готова к импорту любым приложением Python. Вы можете повторить этот процесс для любой библиотеки Python.

Установка библиотеки Python с помощью блокнота Jupyter в VSCode

1) Создание блокнота Jupyter в VSCode

Создайте блокнот Jupyter, выполнив действия, описанные в разделе "Мой первый блокнот Jupyter" в Visual Studio Code (ядро Python)

2) Импорт библиотеки Python

Выполните следующую команду, чтобы убедиться, что pip установлен на вашем компьютере.

Допустим, вы хотите установить библиотеку Pandas Python.
Выполните следующую команду.

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

Просмотр сред

Выберите команду меню «Вид» > «Другие окна» > «Среды Python». Окно Python Environments открывается аналогично обозревателю решений и показывает различные доступные вам среды. В списке показаны как среды, которые вы установили с помощью установщика Visual Studio, так и среды, которые вы установили отдельно. Сюда входят глобальные, виртуальные среды и среды conda. Среда, выделенная жирным шрифтом, — это среда по умолчанию, которая используется для новых проектов. Дополнительные сведения о работе со средами см. в разделе Создание сред Python и управление ими в средах Visual Studio.

Вы также можете использовать сочетание клавиш Ctrl+K, Ctrl+`, чтобы открыть окно Python Environments из окна Solution Explorer. Если ярлык не работает и вы не можете найти окно Python Environments в меню, возможно, вы не установили рабочую нагрузку Python. Инструкции по установке Python см. в разделе Установка поддержки Python в Visual Studio для Windows.

Открыв проект Python, вы можете открыть окно Python Environments из обозревателя решений. Щелкните правой кнопкой мыши Python Environments и выберите View All Python Environments.

Теперь создайте новый проект, выбрав «Файл» > «Создать» > «Проект», выбрав шаблон приложения Python.

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

В окне редактора наведите указатель мыши на операторы импорта numpy и matplotlib. Вы заметите, что они не разрешены. Чтобы разрешить операторы импорта, установите пакеты в глобальную среду по умолчанию.

Когда вы смотрите в окно редактора, обратите внимание, что при наведении курсора на операторы импорта numpy и matplotlib они не разрешаются. Причина в том, что пакеты не были установлены в глобальной среде по умолчанию.

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

На вкладке "Пакеты" в окне "Среды Python" перечислены все пакеты, установленные в настоящее время в среде.

Установка пакетов с помощью окна Python Environments

В окне "Среды Python" выберите среду по умолчанию для новых проектов Python и перейдите на вкладку "Пакеты". Затем вы увидите список пакетов, установленных в данный момент в среде.

Установите matplotlib, введя его имя в поле поиска, а затем выбрав команду «Выполнить»: параметр pip install matplotlib. Выполнение команды установит matplotlib и все пакеты, от которых она зависит (в данном случае это включает numpy ).

Выберите вкладку "Пакеты".

Согласие на повышение прав, если будет предложено это сделать.

После установки пакета он появится в окне Python Environments. X справа от пакета удаляет его.

Введите matplotlib в поле поиска, чтобы установить matplotlib.

Выберите команду «Выполнить: pip install matplotlib». Этот параметр устанавливает matplotlib и все пакеты, от которых он зависит (в данном случае это включает numpy ).

Согласие на повышение прав, если будет предложено это сделать.

После установки пакета он появится в окне Python Environments. X справа от пакета удаляет его.

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

Visual Studio 2017 версии 15.6 и более поздних версий использует другой и более быстрый метод для работы с IntelliSense и отображает соответствующее сообщение на вкладке IntelliSense.

Запустить программу

Теперь, когда matplotlib установлен, запустите программу с помощью (F5) или без отладчика (Ctrl+F5), чтобы увидеть результат:

В этом коротком сообщении показано, как установить пакет Python в Visual Studio Code, который широко используется в среде программирования. Обязательным условием для нашей операции является расширение Python в коде Visual Studio, которое необходимо установить в самом начале (Рис. 1).

Рис. 1 расширение Python в Visual Studio Code.

Вы можете выполнить установку по этой ссылке и получить новейшую версию языка Python.
Далее вы можете без проблем начать программировать на Python в Visual Studio Code. Однако кажется, что вы несколько ограничены, когда обнаруживаете, что есть проблемы с установкой внешних библиотек Python и их импортом в Visual Studio Code. Я надеюсь, что это быстрое решение поможет вам справиться с этими проблемами.
Самой большой проблемой на начальном этапе является предполагаемое отсутствие установки Pip в нашем программном обеспечении Visual Studio Code. Pip — самый популярный инструмент для установки пакетов Python, включающий в себя современную версию Python. Он предоставляет основные функции для поиска, загрузки и установки пакетов Python.
В Visual Studio Code Pip, кажется, не распознается как внутренняя или внешняя команда (рис. 2).Обычно мы выбираем самый быстрый способ установки модуля Python, когда после посещения модуля, который мы хотим получить, мы просто делаем копию верхней команды установки, а затем вставляем ее в наше специальное программное обеспечение Python, то есть PyCharm.

Рис. 2 Ошибка «Pip не распознан» в Visual Studio Code.

В коде Visual Studio нам нужно немного изменить нашу команду pip. Правильная команда в нашем терминале должна быть:

После того, как мы нажмем Enter, весь список команд должен быть заполнен, как показано ниже (рис. 3).

Рис. 3 Часть списка команд для Pip в Visual Studio Code.

Теперь мы уверены, что Pip был распознан нашим кодом Visual Studio. Это означает, что можно установить библиотеку Python, и это здорово.
Для корректной установки мы не можем просто сделать копию основной команды доступной чуть ниже названия библиотеки (Рис. 2).
Если бы мы сделали это, то наша команда выглядела бы так:

и нам пришлось бы удалить одну « pip », чтобы между строками не было хотя бы одного пробела, как вы можете видеть здесь.
Я думаю, что гораздо проще просто ввести py-m в нашем пути к терминалу:

а затем добавить команду библиотеки, которую мы хотим установить (Рис. 2)…

После нажатия кнопки «Ввод» вы увидите ход установки. Далее инструмент сообщит вам информацию о целевом пути, по которому была установлена библиотека, а также о новой версии pip, если она доступна (рис. 4).

Рис. 4 Ход установки библиотеки Python в Visual Studio Code.

Чтобы убедиться, что все в порядке, вы можете импортировать библиотеку в файл, над которым работаете, просто набрав:

Если что-то пойдет не так, консоль Python подчеркнет ваш код волнистой красной линией. Поскольку все установлено правильно, библиотека должна мгновенно распознаваться кодом Visual Studio (Рис. 5).

Рис. 5 Библиотека Python успешно импортирована в Visual Studio Code.

Я настоятельно рекомендую использовать Visual Studio Code — лучшее приложение для кодирования на рынке. Самым большим преимуществом является широкая возможность написания кода на различных языках программирования. Это отличное приложение, которое превосходит другие приложения для программирования, предназначенные для определенного языка. В результате экономится много памяти, благодаря чему наши компьютеры работают быстрее.

Ссылки:

Форумы:

Ютуб:

< /p>

Читайте также: