Desinstalar Python no macOS

A forma de desinstalar o Python no macOS depende de como ele foi instalado, por isso o primeiro passo é sempre descobrir qual instalação você tem. Este artigo cobre os três casos comuns — Homebrew, o instalador do python.org e pyenv — explica por que o Python que acompanha o macOS deve ser deixado em paz, e termina com os arquivos restantes que vale a pena limpar.

Execute which -a python3 no terminal antes de começar. Os caminhos que ele imprime indicam quais seções se aplicam a você: caminhos de /opt/homebrew ou /usr/local/Cellar pertencem ao Homebrew, /Library/Frameworks/Python.framework pertence ao instalador do python.org, e caminhos sob ~/.pyenv pertencem ao pyenv.

Compreender o Python no macOS

Um Mac pode conter várias instalações do Python ao mesmo tempo, e elas não interferem umas nas outras. A Apple inclui um comando python3 com o macOS para suas próprias ferramentas de desenvolvimento, e tudo o que você instalou por conta própria — através do Homebrew, do instalador do python.org ou do pyenv — reside separadamente ao lado dele.

Por isso, “desinstalar o Python” quase sempre significa remover uma cópia que você mesmo instalou, não o Python como um todo. Remover uma cópia da qual outras ferramentas dependem pode quebrá-las, então identifique a instalação que você realmente deseja remover, usando os caminhos de which -a python3, antes de excluir qualquer coisa.

Desinstalar o Python instalado com o Homebrew

Se você instalou o Python com o Homebrew, deixe o Homebrew removê-lo para que os arquivos e links da fórmula sejam limpos de forma consistente. Primeiro, liste as fórmulas do Python que o Homebrew tem instaladas:

brew list | grep python

Desinstale a versão de que você não precisa mais, nomeando a fórmula versionada:

brew uninstall python@3.12

Substitua 3.12 pela versão da sua própria lista. O Homebrew recusa desinstalar uma fórmula da qual outras fórmulas instaladas dependem; se isso acontecer, desinstale primeiro esses dependentes ou, quando tiver certeza de que nada precisa dela, repita o comando com --ignore-dependencies.

Depois, verifique a remoção: a fórmula não aparece mais em brew list | grep python, e which -a python3 não imprime mais um caminho do Homebrew. Se python3 --version ainda responder, é uma das suas instalações restantes — na maioria das vezes a do macOS descrita abaixo.

Desinstalar o Python instalado a partir do python.org

O instalador do python.org não tem um desinstalador próprio. Como descreve a documentação do Python, o instalador coloca três coisas no Mac — uma pasta Python 3.x em /Applications, o framework em /Library/Frameworks/Python.framework e links simbólicos para os executáveis em /usr/local/bin — e para desinstalá-lo, você remove essas três coisas.

Remova uma versão de cada vez. Primeiro, liste as versões presentes no framework:

ls /Library/Frameworks/Python.framework/Versions/

Exclua a versão que você está removendo (aqui 3.12) e sua pasta de Applications:

sudo rm -rf /Library/Frameworks/Python.framework/Versions/3.12
sudo rm -rf "/Applications/Python 3.12"

Em seguida, remova apenas os links simbólicos que apontam para a versão que você excluiu. Liste-os primeiro:

ls -l /usr/local/bin | grep "Python.framework/Versions/3.12"

Exclua cada link que o comando imprimir — por exemplo sudo rm /usr/local/bin/python3.12 — e deixe intactos os links que apontam para outras versões ou para o Homebrew. Se você removeu a última versão do framework, pode excluir o próprio /Library/Frameworks/Python.framework. O instalador também adiciona o diretório bin do framework ao PATH do seu shell em ~/.zprofile ou ~/.bash_profile; remova também essa linha.

Desinstalar o Python instalado via pyenv

O pyenv mantém cada versão que instala sob ~/.pyenv/versions, então remover uma nunca toca nos seus outros Pythons. Liste as versões instaladas:

pyenv versions

Desinstale a versão de que você não precisa mais:

pyenv uninstall 3.12.4

O pyenv pede confirmação e depois exclui o diretório dessa versão. Execute pyenv versions novamente para confirmar que a versão desapareceu; se era sua versão global, defina uma nova com pyenv global ou seu shell recorrerá a outra instalação.

O Python do sistema que acompanha o macOS

O próprio macOS fornece um comando python3 em /usr/bin/python3 para as Xcode Command Line Tools e outros softwares da Apple. A documentação do Python é explícita sobre essa cópia: ela é controlada pela Apple e usada por softwares fornecidos pela Apple e por terceiros, e você nunca deve modificá-la nem tentar excluí-la — ela também fica no volume do sistema selado, então não pode ser removida da maneira normal.

Portanto, nesta seção não há nada para desinstalar. Se python3 --version ainda relatar uma versão depois que você removeu suas próprias instalações, verifique o caminho com which python3: quando ele imprime /usr/bin/python3, essa cópia restante é a do sistema, e deixá-la no lugar é o estado final correto.

Limpar arquivos residuais

Instaladores e gerenciadores de pacotes podem deixar pequenos restos. Os que vale a pena remover são o diretório de biblioteca por usuário da versão que você desinstalou e o cache de downloads do pip:

rm -rf ~/Library/Python/3.12
rm -rf ~/Library/Caches/pip

Ajuste o número da versão para a que você removeu e exclua apenas diretórios que pertencem a essa versão — outra instalação com um número de versão diferente mantém seu próprio diretório e não é afetada. Ambientes virtuais que você criou com o Python removido não funcionarão mais; exclua também essas pastas de projeto, ou recrie-os com um Python restante.

Conclusão

Desinstalar o Python no macOS é um trabalho por instalação: versões do Homebrew saem com brew uninstall, instalações do python.org saem removendo a versão do framework, a pasta Applications e seus links simbólicos /usr/local/bin, e versões do pyenv saem com pyenv uninstall. O Python do sistema do macOS nunca é o alvo — identifique cada cópia com which -a python3, remova apenas a que você pretendia e limpe apenas os seus restos.

FAQ

1. Como verifico quais versões do Python estão instaladas no macOS?
   Execute which -a python3 para ver cada python3 no seu PATH e verifique cada gerenciador separadamente com brew list | grep python e pyenv versions.

2. É seguro desinstalar a versão do sistema do Python?
   Não — e não é necessário. A cópia /usr/bin/python3 pertence ao macOS e às suas ferramentas de desenvolvimento; a documentação do Python diz que ela nunca deve ser modificada ou excluída.

3. Como posso reinstalar o Python depois de desinstalá-lo?
   Instale-o da mesma forma que antes: brew install python para o Homebrew, o instalador do python.org, ou pyenv install seguido do número da versão para o pyenv.

4. O que devo fazer se um comando de desinstalação relatar um erro?
   Leia qual programa o imprimiu. O Homebrew recusa quando outra fórmula depende do Python que está sendo removido; erros de permissão nos arquivos do python.org significam que a etapa sudo foi pulada; um nome de versão não encontrado significa que ele foi instalado por um gerenciador diferente.

5. Posso ter várias versões do Python instaladas simultaneamente?
   Sim. Instalações do Homebrew, do python.org e do pyenv coexistem, e o pyenv existe precisamente para alternar entre várias versões.