Tutorial: Instalar pacotes em seu ambiente python no Visual Studio

2025-06-12

Este artigo apresenta a Etapa 5 da série de tutoriais Trabalhar com Python no Visual Studio.

Todo o código em um projeto do Python é executado no contexto de um ambiente específico. Exemplos de ambientes incluem um ambiente global, um ambiente virtual, um ambiente conda e assim por diante. O ambiente é usado para todas as tarefas que exigem serviços de idioma específicos para a versão do Python e um conjunto de pacotes instalados. Cada ambiente requer determinados pacotes instalados com base no código do projeto.

A comunidade de desenvolvedores do Python produz milhares de pacotes úteis que você pode incorporar em seus próprios projetos. Na Etapa 5 desta série de tutoriais, você usa a janela Ambientes do Python no Visual Studio para gerenciar pacotes em seus ambientes do Python.

Na Etapa 5 do tutorial, você aprenderá a:

Exibir ambientes e pacotes do Python no Visual Studio
Instalar e gerenciar pacotes para ambientes do Python
Testar código python com pacotes instalados

Pré-requisitos

Um projeto de aplicativo Python que tem um arquivo Python (.py) com código criado na etapa 2 do : gravar e executar o código python.

Exibir ambientes do Python no Visual Studio

O Visual Studio fornece dois locais para exibir informações sobre ambientes do Python:

O Ambientes do Pythonnó no Gerenciador de Soluções lista os ambientes em uso no momento pelo projeto. Se você tiver mais de um ambiente para um projeto, o Visual Studio mostrará o ambiente ativo em negrito. Você pode expandir um ambiente específico para ver o conjunto de pacotes instalados. Quando um ambiente está ativo, você pode importar seus pacotes instalados e usá-los em seu código.
A janela Ambientes do Python exibe todos os ambientes disponíveis e seus pacotes instalados. Você pode exibir ambientes instalados usando o Instalador do Visual Studio e ambientes instalados separadamente. Os ambientes disponíveis incluem ambientes globais, virtuais e conda. O Visual Studio mostra o ambiente python padrão para novos projetos em negrito.

Use um dos seguintes métodos para abrir a janela Ambientes do Python:

Para acessar a janela na barra de ferramentas principal no Visual Studio, selecione Exibir>Outras Janelas>Ambientes do Python.
Se você tiver um projeto do Python aberto no Gerenciador de Soluções, clique com o botão direito do mouse no nó Ambientes do Python dentro do projeto e selecione Exibir Todos os Ambientes do Python:

Você também pode usar o atalho de teclado Ctrl+K, Ctrl+` para abrir a janela Ambientes do Python do Gerenciador de Soluções.

Preparar o arquivo Python

Para se preparar para o exercício, siga estas etapas para atualizar o arquivo de projeto do Python para incluir o código necessário:

Abra o arquivo de projeto do Python (.py) no editor. (A Etapa 2 do Tutorial explica como criar esse arquivo, em que o nome do arquivo padrão é PythonApplication1.py.)

Substitua o código no arquivo pelo código a seguir. Essa versão do código cria uma onda cossenoidal semelhante à saída da Etapa 4 do tutorial, mas traça a saída graficamente.

from math import radians
import numpy as np                # installed with matplotlib
import matplotlib.pyplot as plt

def main():
   x = np.arange(0, radians(1800), radians(12))
   plt.plot(x, np.cos(x), 'b')
   plt.show()

main()

No editor, passe o mouse sobre a instrução de importação matplotlib. O Visual Studio usa formatação especial para indicar que a instrução não foi resolvida.

A instrução de importação matplotlib não foi resolvida porque os pacotes necessários não estão instalados no ambiente global padrão. Você aprenderá a instalar os pacotes necessários na próxima seção.

Instalar pacotes para o ambiente do Python

Para resolver a instrução de importação matplotlib, você precisa instalar os pacotes necessários no ambiente global padrão:

Na janela Ambientes do Python, selecione o ambiente padrão para novos projetos do Python e, em seguida, selecione Pacotes (PyPI) no menu suspenso. (PyPI é o acrônimo para o Índice de Pacotes do Python.)

O Visual Studio mostra a lista de pacotes atualmente instalados no ambiente padrão.
No campo Pesquisa, insira matplotlib. Na lista de resultados, selecione a opção Executar comando: pip install matplotlib.

O comando instala a biblioteca de matplotlib e também todos os pacotes dos quais ele depende. Nesse caso, os pacotes dependentes incluem a biblioteca de numpy.

Você pode abrir a janela Exibição>Saída para monitorar o progresso da instalação.
Após a instalação dos pacotes, a janela Ambientes do Python é atualizada para mostrar os pacotes para o ambiente selecionado:

O X à direita do pacote o desinstala.