{"id":37118,"date":"2025-02-04T17:37:11","date_gmt":"2025-02-04T20:37:11","guid":{"rendered":"https:\/\/www.locaweb.com.br\/ajuda\/?post_type=ht_kb&#038;p=37118"},"modified":"2025-02-04T17:37:11","modified_gmt":"2025-02-04T20:37:11","slug":"python-venv","status":"publish","type":"ht_kb","link":"https:\/\/www.locaweb.com.br\/ajuda\/wiki\/python-venv\/","title":{"rendered":"Como criar um ambiente virtual em Python com venv?"},"content":{"rendered":"<p>A ferramenta <strong>Python venv<\/strong> permite criar ambientes virtuais para isolar cada trabalho e evitar conflitos entre diferentes vers\u00f5es.<\/p>\n<p>Com esse recurso, voc\u00ea pode trabalhar em v\u00e1rios projetos ao mesmo tempo, sem se preocupar com interfer\u00eancias entre diferentes bibliotecas instaladas no sistema. Al\u00e9m disso, fica mais f\u00e1cil gerenciar pacotes de forma eficiente e trabalhar em equipe sem conflitos.<\/p>\n<h2>Por que usar ambientes virtuais em Python?<\/h2>\n<p>Ambientes virtuais s\u00e3o <strong>espa\u00e7os exclusivos para cada projeto <\/strong><strong>Python<\/strong>, em que todas as ferramentas e configura\u00e7\u00f5es funcionam em harmonia, sem interferir umas nas outras.<\/p>\n<p>Nesses espa\u00e7os, <strong>cada trabalho funciona de forma independente<\/strong>, com suas pr\u00f3prias bibliotecas e configura\u00e7\u00f5es espec\u00edficas.<\/p>\n<p>Conhe\u00e7a os benef\u00edcios reais dessa abordagem:<\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li><strong>Isolamento de depend\u00eancias<\/strong>: cada projeto mant\u00e9m as suas pr\u00f3prias bibliotecas. Assim, se um projeto precisa da vers\u00e3o 2.0 de uma biblioteca e outro necessita da vers\u00e3o 3.0, ambos podem coexistir sem conflitos;<\/li>\n<li><strong>Facilidade na colabora\u00e7\u00e3o<\/strong>: quando uma equipe trabalha em conjunto, todos podem utilizar exatamente as mesmas vers\u00f5es das bibliotecas, o que torna a colabora\u00e7\u00e3o muito mais fluida;<\/li>\n<li><strong>Organiza\u00e7\u00e3o do sistema<\/strong>: ao manter cada projeto com as suas pr\u00f3prias depend\u00eancias, o sistema principal permanece limpo e organizado. \u00c9 como ter um dep\u00f3sito em que cada c\u00f4modo guarda apenas o que realmente precisa, sem acumular itens desnecess\u00e1rios.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h2>Pr\u00e9-requisitos<\/h2>\n<p>Antes de come\u00e7ar a desenvolver com Python, \u00e9 preciso <strong>verificar se a linguagem foi instalada no seu sistema<\/strong>, seja ele uma m\u00e1quina local ou um <a href=\"https:\/\/www.locaweb.com.br\/servidor-vps\/\" target=\"_blank\" rel=\"noopener noreferrer\">VPS<\/a> (Servidor Virtual Privado).<\/p>\n<p>Para quem usa<strong> Linux<\/strong>, o comando<\/p>\n<pre><em>python venv linux<\/em><\/pre>\n<p>pode ser utilizado para facilitar a cria\u00e7\u00e3o e a ativa\u00e7\u00e3o do ambiente virtual diretamente no terminal.<\/p>\n<p>Caso utilize o <strong>Visual Studio Code<\/strong>, voc\u00ea tamb\u00e9m pode usar o suporte direto para ambientes virtuais, o que facilita a configura\u00e7\u00e3o com comandos como<\/p>\n<pre><em>python venv vscode.<\/em><\/pre>\n<p>J\u00e1 para <strong>verificar a vers\u00e3o do Python<\/strong> (<em>python venv version<\/em>), abra o terminal (no Linux ou macOS) ou o prompt de comando (no Windows) e digite:<\/p>\n<pre><em>python --version.<\/em><\/pre>\n<p>A seguir, saiba mais sobre como verificar esses pr\u00e9-requisitos.<\/p>\n<h3>Verificar a instala\u00e7\u00e3o do Python<\/h3>\n<p>Para verificar se o Python est\u00e1 instalado no seu sistema, basta <strong>abrir o terminal<\/strong> (no Linux ou macOS) <strong>ou o prompt de comando<\/strong> (no Windows) e digitar o seguinte c\u00f3digo:<\/p>\n<pre><em>$ python --version<\/em>.<\/pre>\n<p>Ou, em algumas distribui\u00e7\u00f5es e configura\u00e7\u00f5es, voc\u00ea precisar\u00e1 usar:<\/p>\n<pre><em>$ python3 --version<\/em>.<\/pre>\n<p>Se o Python estiver instalado corretamente, voc\u00ea ver\u00e1 uma sa\u00edda semelhante \u00e0 seguinte: <em>Python 3.9.1<\/em>.<\/p>\n<p><strong>O n\u00famero exibido pode variar<\/strong>, a depender de qual vers\u00e3o foi instalada em seu dispositivo.<\/p>\n<h2>Passo a passo: criar um ambiente virtual com venv<\/h2>\n<p>O m\u00f3dulo venv, inclu\u00eddo nas vers\u00f5es mais recentes do Python, facilita a cria\u00e7\u00e3o e a gest\u00e3o de ambientes virtuais, o que isola bibliotecas e depend\u00eancias de cada projeto.<\/p>\n<p>Muitos <a href=\"https:\/\/www.locaweb.com.br\/blog\/temas\/codigo-aberto\/ide-o-que-e-um-ambiente-de-desenvolvimento-integrado\/\" target=\"_blank\" rel=\"noopener noreferrer\">IDEs<\/a> (Ambientes de Desenvolvimento Integrado) oferecem suporte \u00e0 cria\u00e7\u00e3o e \u00e0 gest\u00e3o desses ambientes virtuais, o que permite que voc\u00ea evite conflitos entre diferentes vers\u00f5es de bibliotecas em projetos distintos.<\/p>\n<p>A seguir, confira o passo a passo para criar e utilizar esse espa\u00e7o de isolamento, o que assegura um desenvolvimento mais organizado e eficiente.<\/p>\n<h3>Passo 1: escolher o diret\u00f3rio do ambiente virtual<\/h3>\n<p>Primeiro, voc\u00ea precisa decidir o local em que o seu ambiente virtual vai ficar. Pode ser em <strong>uma pasta que voc\u00ea j\u00e1 usa<\/strong> para os seus projetos Python ou, se preferir, <strong>um novo diret\u00f3rio<\/strong> criado especialmente para isso.<\/p>\n<h3>Passo 2: criar o ambiente virtual<\/h3>\n<p>No terminal, <strong>v\u00e1 at\u00e9 o diret\u00f3rio que escolheu e execute o seguinte comando<\/strong>:<\/p>\n<pre><em>$ python3 -m <\/em><em>venv nome_do_ambiente<\/em><em>.<\/em><\/pre>\n<p>Nesse exemplo, o Python criar\u00e1 um ambiente virtual chamado &#8220;nome_do_ambiente&#8221;. Mas voc\u00ea pode escolher qualquer nome, basta modific\u00e1-lo no comando acima.<\/p>\n<p>Em seguida, <strong>abra o seu terminal, navegue at\u00e9 o diret\u00f3rio escolhido e digite o seguinte comando<\/strong>:<\/p>\n<pre><em>$ python3 -m venv nome_do_ambiente<\/em>.<\/pre>\n<p>N\u00e3o se preocupe com o nome, voc\u00ea pode personaliz\u00e1-lo como quiser. Por exemplo, se o trabalho \u00e9 em um blog, poderia cham\u00e1-lo de &#8220;blog_venv&#8221; ou algo similar.<\/p>\n<p>Esse comando cria o seu espa\u00e7o isolado de desenvolvimento, pronto para receber todas as ferramentas necess\u00e1rias para o seu projeto.<\/p>\n<h3>Passo 3: ativar o ambiente virtual<\/h3>\n<p>Ap\u00f3s criar o ambiente virtual, \u00e9 necess\u00e1rio ativ\u00e1-lo para que as instala\u00e7\u00f5es de pacotes e execu\u00e7\u00f5es de scripts ocorram dentro desse ambiente isolado.<\/p>\n<p>O procedimento varia conforme o sistema operacional. O comando de ativa\u00e7\u00e3o costuma seguir o formato <em>python <\/em><em>venv<\/em><em> activate<\/em>, com pequenas varia\u00e7\u00f5es de acordo com o sistema.<\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li><strong>No Windows<\/strong>: abra o Prompt de Comando e execute:\n<pre><em>nome_do_ambiente\\Scripts\\activate;<\/em><\/pre>\n<\/li>\n<li><strong>No macOS e Linux<\/strong>: abra o Terminal e execute:<\/li>\n<li>\n<pre><em>source nome_do_ambiente\/bin\/activate<\/em>.<\/pre>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p>O nome do ambiente virtual aparecer\u00e1 no in\u00edcio do prompt, a fim de indicar que o ambiente est\u00e1 ativo.<\/p>\n<h3>Passo 4: instalar depend\u00eancias dentro do ambiente<\/h3>\n<p>Com o ambiente virtual ativo, voc\u00ea pode instalar as bibliotecas necess\u00e1rias para o seu projeto ao utilizar <em>python <\/em><em>venv<\/em><em> install<\/em> seguido pelo nome do pacote.<\/p>\n<p>Por exemplo, para instalar a biblioteca <em>requests<\/em>, basta usar o comando:<\/p>\n<pre><em>pip install requests<\/em>.<\/pre>\n<p>As bibliotecas instaladas dessa forma ser\u00e3o exclusivas do ambiente virtual, o que evita conflitos com outras instala\u00e7\u00f5es.<\/p>\n<p>O comando <em>python <\/em><em>venv<\/em><em> install<\/em> <strong>ajuda a gerenciar as depend\u00eancias<\/strong> dentro do ambiente de forma isolada e organizada.<\/p>\n<h3>Passo 5: desativar o ambiente virtual<\/h3>\n<p>Ap\u00f3s encerrar o seu projeto, \u00e9 hora de desativar o ambiente virtual e retornar ao ambiente global do Python.<\/p>\n<p>O procedimento \u00e9 bastante simples: basta executar o c\u00f3digo<\/p>\n<pre><em>deactivate<\/em><\/pre>\n<p>O comando <strong>funciona tanto no Windows quanto no macOS e Linux<\/strong>.<\/p>\n<h2>Gerenciar depend\u00eancias do projeto<\/h2>\n<p>Para que um projeto Python funcione de forma correta em diferentes ambientes, \u00e9 fundamental gerenciar as suas depend\u00eancias. Dessa forma, o trabalho colaborativo de desenvolvimento tamb\u00e9m fica mais f\u00e1cil.<\/p>\n<p>Uma pr\u00e1tica comum e eficaz nessa gest\u00e3o \u00e9 o uso do arquivo <em>requirements.txt<\/em>. Veja, a seguir, como utiliz\u00e1-lo.<\/p>\n<h3>Uso do requirements.txt<\/h3>\n<p>O <em>requirements.txt<\/em> \u00e9 um arquivo de texto que <strong>lista todas as bibliotecas e suas vers\u00f5es necess\u00e1rias<\/strong> para o projeto Python. Ao compartilhar esse arquivo, outros desenvolvedores podem replicar o ambiente e instalar as mesmas depend\u00eancias nas vers\u00f5es especificadas.<\/p>\n<p>Para gerar o <em>requirements.txt<\/em>, siga os passos abaixo:<\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li>Ative o ambiente virtual do seu projeto por meio do seguinte comando para listar as depend\u00eancias instaladas:<\/li>\n<li>\n<pre><em>pip freeze &gt; requirements.txt<\/em>;<\/pre>\n<\/li>\n<li>Essa a\u00e7\u00e3o vai criar um arquivo <em>requirements.txt<\/em> que cont\u00e9m todas as bibliotecas instaladas no ambiente virtual, junto com as suas respectivas vers\u00f5es;<\/li>\n<li>Para instalar todas as depend\u00eancias listadas no requirements.txt em um novo ambiente virtual, execute o c\u00f3digo:<\/li>\n<li>\n<pre><em>pip install -r requirements.txt<\/em>;<\/pre>\n<\/li>\n<li>Assim, o arquivo <em>requirements.txt<\/em> ser\u00e1 lido e todas as bibliotecas especificadas ser\u00e3o instaladas nas vers\u00f5es indicadas.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h2>Dicas adicionais para ambientes virtuais<\/h2>\n<p>Ao trabalhar com ambientes virtuais em Python, principalmente em projetos colaborativos, \u00e9 fundamental <strong>adotar pr\u00e1ticas que garantam a organiza\u00e7\u00e3o e a efici\u00eancia do desenvolvimento<\/strong>.<\/p>\n<p>A seguir, confira mais algumas dicas para otimizar o seu trabalho.<\/p>\n<h3>Como adicionar ao .gitignore<\/h3>\n<p>Para <strong>evitar que os arquivos do ambiente virtual sejam inclu\u00eddos no controle de vers\u00e3o<\/strong>, \u00e9 recomend\u00e1vel adicion\u00e1-los ao arquivo <em>.gitignore<\/em>. Isso mant\u00e9m o reposit\u00f3rio limpo e evita conflitos desnecess\u00e1rios.<\/p>\n<p>No arquivo <em>.gitignore<\/em>, <strong>inclua a linha correspondente ao diret\u00f3rio do seu ambiente virtual<\/strong>.<\/p>\n<p>Por exemplo, se o ambiente virtual estiver na pasta venv, adicione:<\/p>\n<pre><em>venv\/<\/em>.<\/pre>\n<p>Essa pr\u00e1tica <strong>assegura que o <\/strong><strong>diret\u00f3rio venv<\/strong><strong> e o seu conte\u00fado sejam ignorados pelo Git<\/strong>.<\/p>\n<h3>Usar o venv em projetos colaborativos<\/h3>\n<p>Para que todos os desenvolvedores trabalhem com as mesmas depend\u00eancias e vers\u00f5es de pacotes em projetos colaborativos, siga os passos abaixo:<\/p>\n<p>1. Crie um ambiente virtual para o projeto com o comando:<\/p>\n<pre><em>python -m <\/em><em>venv<\/em> <em>venv<\/em>;<\/pre>\n<p>2. Ative o ambiente virtual \u2014 no Windows, utilize:<em> venv\\Scripts\\activate<\/em>; no macOS e Linux, use:<\/p>\n<pre><em>source venv\/bin\/activate<\/em>;<\/pre>\n<p>3. Instale as depend\u00eancias necess\u00e1rias:<\/p>\n<pre><em>pip install <\/em><em>nome_do_pacote<\/em>;<\/pre>\n<p>4. Gere o arquivo <em>requirements.txt<\/em> com as depend\u00eancias do projeto:<\/p>\n<pre><em>pip freeze &gt; requirements.txt<\/em>;<\/pre>\n<p>5. Compartilhe o arquivo <em>requirements.txt<\/em> no reposit\u00f3rio;<\/p>\n<p>6. Os colaboradores podem replicar o ambiente virtual localmente: crie e ative o ambiente virtual conforme os passos 1 e 2.<\/p>\n<p>Instale as depend\u00eancias a partir do requirements.txt:<\/p>\n<pre><em>pip install -r requirements.txt<\/em>.<\/pre>\n<p>Ao seguir essas etapas, todos os membros da equipe trabalhar\u00e3o com as mesmas configura\u00e7\u00f5es, o que <strong>minimizar\u00e1 problemas de compatibilidade e facilitar\u00e1 a colabora\u00e7\u00e3o<\/strong>.<\/p>\n<p>Agora que voc\u00ea j\u00e1 sabe como criar, ativar e gerenciar ambientes virtuais em Python com o venv, \u00e9 hora de aplicar esses conhecimentos para organizar os seus projetos de forma mais eficiente.<\/p>\n<p>A cria\u00e7\u00e3o de ambientes isolados n\u00e3o s\u00f3 evita conflitos entre bibliotecas, como tamb\u00e9m facilita o trabalho em equipe e a manuten\u00e7\u00e3o de diferentes vers\u00f5es de pacotes.<\/p>\n<p>Para mais dicas sobre organiza\u00e7\u00e3o e otimiza\u00e7\u00e3o de ambientes de desenvolvimento em Python, confira os nossos conte\u00fados exclusivos e potencialize ainda mais os seus projetos!<\/p>\n","protected":false},"excerpt":{"rendered":"<p>A ferramenta Python venv permite criar ambientes virtuais para isolar cada trabalho e evitar conflitos entre diferentes vers\u00f5es. Com esse recurso, voc\u00ea pode trabalhar em v\u00e1rios projetos ao mesmo tempo, sem se preocupar com interfer\u00eancias entre diferentes bibliotecas instaladas no sistema. Al\u00e9m disso, fica mais f\u00e1cil gerenciar pacotes de forma&#8230;<\/p>\n","protected":false},"author":50,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"ht-kb-category":[118],"ht-kb-tag":[],"class_list":["post-37118","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-vps-locaweb"],"_links":{"self":[{"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/ht-kb\/37118","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/users\/50"}],"replies":[{"embeddable":true,"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/comments?post=37118"}],"version-history":[{"count":1,"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/ht-kb\/37118\/revisions"}],"predecessor-version":[{"id":37119,"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/ht-kb\/37118\/revisions\/37119"}],"wp:attachment":[{"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/media?parent=37118"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/ht-kb-category?post=37118"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/ht-kb-tag?post=37118"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}