Como Criar um Ambiente Conda: Guia Completo com Exemplos

Name

Kanaries Team

Updated on 24/11/2025

Gerenciar dependências Python em múltiplos projetos pode rapidamente se tornar um pesadelo. Diferentes projetos requerem diferentes versões de pacotes, e instalar tudo em um único ambiente gera conflitos de versões e código quebrado. Os ambientes Conda resolvem esse problema criando espaços isolados para as dependências de cada projeto.

Este guia cobre tudo o que você precisa saber sobre a criação de ambientes Conda, desde comandos básicos até técnicas avançadas como clonagem e configuração baseada em YAML.

Quer criar rapidamente visualizações de dados a partir de Python Pandas DataFrame sem código?

PyGWalker é uma biblioteca Python para análise exploratória de dados com visualização. PyGWalker (opens in a new tab) pode simplificar seu fluxo de trabalho de análise e visualização de dados no Jupyter Notebook, transformando seu pandas dataframe em uma interface de usuário alternativa ao Tableau para exploração visual.

(opens in a new tab)

O que é um Ambiente Conda?

Um ambiente Conda é um diretório isolado contendo uma coleção específica de pacotes e suas dependências. Cada ambiente opera de forma independente, permitindo que você:

• Use diferentes versões de Python para diferentes projetos
• Instale versões de pacotes conflitantes sem problemas
• Compartilhe configurações de desenvolvimento reproduzíveis com colegas de equipe
• Mantenha sua instalação base limpa e estável

Referência Rápida: Comandos de Ambiente Conda

Criando um Ambiente Conda Básico

A maneira mais simples de criar um ambiente Conda usa o comando conda create:

conda create --name meuenv

Isso cria um ambiente vazio chamado meuenv. Para criar e ativar em um único fluxo de trabalho:

conda create --name meuenv
conda activate meuenv

Após a ativação, seu prompt de terminal muda para mostrar o nome do ambiente ativo.

Criando um Ambiente com uma Versão Python Específica

A maioria dos projetos requer uma versão Python específica. Especifique-a durante a criação:

conda create --name meuenv python=3.11

Você também pode especificar um intervalo de versões:

# Python 3.10 ou superior
conda create --name meuenv python>=3.10
 
# Python 3.9.x (qualquer versão patch)
conda create --name meuenv python=3.9

Versões Python Suportadas

Criando um Ambiente com Pacotes

Instale pacotes durante a criação do ambiente para economizar tempo:

conda create --name dataenv python=3.11 numpy pandas matplotlib scikit-learn

Especifique versões de pacotes para reprodutibilidade:

conda create --name dataenv python=3.11 numpy=1.24 pandas=2.0 matplotlib=3.7

Criando um Ambiente a partir de um Arquivo YAML

Para projetos complexos, defina ambientes em um arquivo YAML. Esta abordagem permite controle de versão e fácil compartilhamento.

Criando o Arquivo environment.yml

name: meuprojeto
channels:
  - conda-forge
  - defaults
dependencies:
  - python=3.11
  - numpy=1.24
  - pandas=2.0
  - scikit-learn=1.3
  - matplotlib=3.7
  - jupyter
  - pip
  - pip:
    - pygwalker
    - pacote-apenas-pip

Criando o Ambiente a partir de YAML

conda env create -f environment.yml

Este comando lê o arquivo e cria um ambiente com o nome e pacotes especificados.

Atualizando um Ambiente Existente a partir de YAML

conda env update -f environment.yml --prune

A flag --prune remove pacotes não listados no arquivo YAML.

Clonando um Ambiente Existente

Duplique um ambiente para experimentar sem afetar o original:

conda create --name novoenv --clone antigoenv

Isso copia todos os pacotes e suas versões exatas. Cenários úteis incluem:

• Testar atualizações de pacotes com segurança
• Criar variações específicas de projeto
• Fazer backup de um ambiente funcional antes de mudanças importantes

Criando Ambientes em Localizações Personalizadas

Por padrão, o Conda armazena ambientes no diretório envs. Crie um ambiente em outro local usando --prefix:

conda create --prefix ./envs/meuenv python=3.11

Ative-o com o caminho completo:

conda activate ./envs/meuenv

Esta abordagem mantém as dependências do projeto dentro da pasta do projeto.

Melhores Práticas para Ambientes Conda

1. Use Nomes Descritivos

Nomeie ambientes de acordo com projetos ou propósitos:

# Bom
conda create --name webapp-backend python=3.11
conda create --name analise-dados python=3.10
 
# Evitar
conda create --name env1
conda create --name teste

2. Sempre Especifique a Versão Python

Versões explícitas previnem comportamento inesperado:

conda create --name meuenv python=3.11

3. Exporte Ambientes para Compartilhamento

Crie arquivos de ambiente reproduzíveis:

# Exportação completa (específica da plataforma)
conda env export > environment.yml
 
# Exportação multiplataforma
conda env export --from-history > environment.yml

4. Use o Canal conda-forge

O canal conda-forge oferece mais pacotes e atualizações mais rápidas:

conda create --name meuenv -c conda-forge python=3.11 numpy pandas

5. Mantenha Ambientes Mínimos

Instale apenas pacotes necessários. Remova ambientes não utilizados regularmente usando o comando conda env remove.

Solução de Problemas Comuns

Criação de Ambiente Falha

Problema: Erro ResolvePackageNotFound

Solução: Tente usar o canal conda-forge ou verifique a ortografia do nome do pacote:

conda create --name meuenv -c conda-forge python=3.11 nome-pacote

Criação de Ambiente Lenta

Problema: Resolver o ambiente demora muito

Solução: Use o mamba, um substituto mais rápido:

conda install -n base -c conda-forge mamba
mamba create --name meuenv python=3.11 numpy pandas

Conda Não Encontrado Após Instalação

Problema: conda: command not found

Solução: Inicialize o Conda para seu shell:

conda init bash  # ou zsh, fish, powershell

Em seguida, reinicie seu terminal.

Gerenciando Seus Ambientes

Após criar ambientes, você precisará gerenciá-los efetivamente:

• Listar ambientes: conda env list mostra todos os ambientes e suas localizações
• Remover ambientes: Consulte nosso guia sobre como remover ambientes Conda para instruções detalhadas
• Atualizar pacotes: Use conda update --all em um ambiente ativado

Conda Create vs Conda Env Create

Existem dois comandos para criar ambientes:

Use conda create para criação rápida de ambiente inline. Use conda env create ao trabalhar com arquivos YAML.

FAQ

Como criar um ambiente Conda com uma versão Python específica?

Use conda create --name meuenv python=3.11 substituindo 3.11 pela versão desejada. O Conda baixa e instala a versão Python especificada no novo ambiente isolado.

Qual é a diferença entre conda create e conda env create?

conda create cria ambientes com pacotes especificados inline na linha de comando. conda env create cria ambientes a partir de arquivos de especificação YAML. Use conda create para configurações rápidas e conda env create para ambientes reproduzíveis e controlados por versão.

Como criar um ambiente Conda a partir de um arquivo requirements.txt?

Primeiro crie o ambiente, depois instale a partir de requirements.txt: conda create --name meuenv python=3.11 seguido de pip install -r requirements.txt após ativar o ambiente. Para melhor compatibilidade, converta requirements.txt para o formato environment.yml.

Posso criar um ambiente Conda em um diretório específico?

Sim, use a flag --prefix: conda create --prefix ./meuenv python=3.11. Isso cria o ambiente no caminho especificado em vez do diretório envs padrão do Conda. Ative-o usando o caminho completo.

Guias Relacionados

• Como Remover Ambiente Conda - Aprenda como remover corretamente ambientes Conda
• Documentação Oficial do Conda (opens in a new tab) - Referência completa sobre gerenciamento de ambientes