HOWTO · Python
Como desinstalar completamente o Miniconda
Desinstale o Miniconda com segurança no Windows, macOS ou Linux e remova restos opcionais apenas quando necessário.
Nesta página
Para desinstalar o Miniconda com segurança, primeiro exporte os ambientes que deseja manter, identifique o prefixo exato da instalação e use o desinstalador específico do sistema operacional. Remova configurações do shell e dados de usuário do conda apenas se realmente quiser uma redefinição completa: essas etapas opcionais podem descartar configurações e pacotes em cache.
Fazer backup dos ambientes e identificar o prefixo de instalação
Desinstalar uma instalação do Miniconda remove os ambientes e pacotes guardados nesse diretório. Antes de continuar, exporte um ambiente que talvez queira recriar depois. Por exemplo, execute conda env export --name myenv > myenv.yml e mantenha myenv.yml fora do diretório do Miniconda. Depois de reinstalar o conda, recrie-o com conda env create --file myenv.yml.
Não exclua um diretório apenas porque o nome parece Miniconda. No macOS e Linux, peça primeiro ao conda o prefixo base. Esta verificação prévia mostra o diretório quando o conda está disponível e interrompe antes de qualquer exclusão quando não está.
if ! prefix="$(conda info --base 2>/dev/null)"; then
printf '%s\n' 'conda is not on PATH; find the installation prefix before deleting anything.'
exit 1
fi
printf 'Miniconda prefix: %s\n' "$prefix"
Em uma instalação funcional, a última linha tem esta forma:
Miniconda prefix: /opt/miniconda3
Se a verificação indicar que conda não está em PATH, não use um caminho adivinhado em um comando de remoção. Localize primeiro o diretório do instalador original ou use o desinstalador fornecido com essa instalação. Essa precaução evita que um prefixo errado remova outra instalação do conda.
Desinstalar o Miniconda no Windows
Use o desinstalador do Windows fornecido com a instalação do Miniconda. Abra Configurações > Aplicativos > Aplicativos instalados (ou Aplicativos e recursos em versões antigas), selecione Miniconda e escolha Desinstalar. O guia de desinstalação do Anaconda Miniconda documenta o procedimento atualmente suportado.
Feche o Prompt de Comando, PowerShell, terminais da IDE e processos Python que usam essa instalação antes de iniciar. Ao terminar, abra um novo terminal e execute where conda. Se esta era sua única instalação do conda, a mensagem de que nenhum executável correspondente foi encontrado é esperada. Se ainda houver um caminho, examine-o: ele pode pertencer a outra instalação Anaconda, Miniconda ou Miniforge que não deve ser removida por engano.
Desinstalar o Miniconda no macOS ou Linux
Quando o instalador o fornecer, execute o script uninstall.sh a partir do prefixo exato do Miniconda identificado. Siga as instruções do script em vez de copiar um comando genérico rm -rf. O guia oficial separa essa remoção suportada da limpeza opcional porque desinstaladores podem deixar configurações no nível do usuário.
Se o desinstalador não estiver disponível, a exclusão manual é alternativa, não primeira opção. Confira novamente o prefixo, garanta que é a instalação do Miniconda que pretende remover e exclua somente esse diretório. A documentação do conda explica a abordagem manual e a limpeza opcional para macOS. rm -rf não pede confirmação e não pode ser desfeito; nunca o execute com um caminho vazio, não verificado ou amplo, como seu diretório pessoal.
Após a remoção, abra um novo shell e execute command -v conda. Nenhuma saída significa que o comando não é mais encontrado pelo PATH atual. Se imprimir um caminho, outra instalação do conda permanece ou o shell conservou uma entrada de inicialização.
Remover restos opcionais do shell e dos dados de usuário
A desinstalação principal não exige excluir todos os arquivos relacionados ao conda. Escolha estas etapas somente se quiser redefinir o conda para a conta de usuário:
- Reverta a inicialização do shell com
conda init --reverse --allantes de remover a instalação, enquantocondaestiver disponível. Como alternativa, depois de revisar o arquivo de inicialização relevante, remova apenas o bloco de inicialização do conda. - Considere remover
.condarc,.condae.continuumapenas se não precisar das configurações, pacotes em cache ou outros dados de usuário. Se tiver dúvidas, guarde uma cópia primeiro. - Verifique
.bashrc,.zshrcou o perfil do PowerShell em busca de caminhos Miniconda obsoletos. Remova somente as linhas referentes à instalação excluída e inicie um novo terminal.
Não use anaconda-clean como o principal desinstalador do Miniconda. Ele é um utilitário de limpeza; a instalação em si deve ser tratada pelo desinstalador suportado ou por uma alternativa manual cuidadosamente verificada. A limpeza opcional ajuda ao reinstalar do zero, mas não é necessária apenas para recuperar o diretório do Miniconda.
Verificar o resultado e reinstalar se necessário
A verificação deve mostrar que o prefixo removido desapareceu e que um terminal novo não resolve mais conda nem o executável Python antigo desse prefixo. No Windows, use where conda; no macOS ou Linux, use command -v conda. Se um comando ainda for resolvido, compare o local informado com o prefixo removido antes de mudar PATH ou excluir outra coisa.
Você pode reinstalar o Miniconda depois sem restaurar arquivos de configuração antigos. Quando necessário, crie um novo ambiente a partir do arquivo YAML salvo. Se a remoção falhar porque um arquivo está em uso ou a permissão foi negada, feche programas que usam a instalação e execute novamente o desinstalador suportado com as permissões adequadas; não force a exclusão de um caminho não verificado.