DEV Community

Cover image for Guia Definitivo: Configurando um Ambiente Python no macOS (2026)
Francisco Júnior
Francisco Júnior

Posted on

Guia Definitivo: Configurando um Ambiente Python no macOS (2026)

#ambiente #python #vscode #zsh

Configurar o Python no macOS parece simples, mas quem nunca se deparou com conflitos de versão ou bagunça no sistema global? Neste guia, vamos construir um ambiente do zero, utilizando Homebrew, Zsh e Automação de Workflow para que você nunca mais perca tempo configurando pastas e ambientes virtuais manualmente.

1. A Fundação: Homebrew e Python

O macOS vem com uma versão do Python, mas você nunca deve usá-la para desenvolvimento. Ela é para o sistema operacional. Vamos usar o Homebrew para gerenciar nossas próprias versões.

Instalando o Homebrew

Se você ainda não tem, abra o Terminal e rode:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Enter fullscreen mode Exit fullscreen mode

Instalando o Python 

brew install python
Enter fullscreen mode Exit fullscreen mode

2. Organizando a Casa: O arquivo .zshrc

O seu shell (Zsh) é o coração da sua produtividade. Vamos editá-lo para garantir que o sistema sempre saiba onde encontrar as ferramentas certas.

Abra o arquivo:

nano ~/.zshrc
Enter fullscreen mode Exit fullscreen mode

Adicione estas linhas para garantir que o Python do Homebrew tenha prioridade:

export PATH="/usr/local/opt/python/libexec/bin:$PATH"
Enter fullscreen mode Exit fullscreen mode

3. Próximo Passo: Blindando seu Ambiente

Para evitar que bibliotecas de um projeto quebrem outro, usamos Virtual Environments (venv). Mas, em vez de criar tudo na mão toda vez, vamos automatizar.

O Script de Automação: start-python

Adicione a seguinte função ao seu ~/.zshrc. Esse script cria a pasta do projeto, inicializa o Git, cria um .gitignore padrão e configura o ambiente virtual com um único comando.

function start-python() {
    mkdir -p "$1" && cd "$1"
    python3 -m venv .venv
    git init
    echo ".venv/
__pycache__/
*.pyc
.DS_Store
.env" > .gitignore
    source .venv/bin/activate
    echo "Nome do Projeto: $1" > README.md
    echo "print('Hello, Python!')" > main.py
    clear
    echo "✅ Ambiente '$1' pronto e blindado!"
    code .
}
Enter fullscreen mode Exit fullscreen mode

Após salvar o arquivo, rode source ~/.zshrc para aplicar as mudanças.

4. Turbinando o VS Code

Para que o VS Code reconheça sua estrutura automaticamente, precisamos ajustar as configurações do Workspace.

  1. Abra o VS Code.
  2. Instale a extensão Python (da Microsoft).
  3. Pressione Cmd + Shift + P e digite "Python: Select Interpreter".
  4. O VS Code geralmente detecta a pasta .venv que nosso script criou. Selecione-a.

Dica Pro: Para automatizar ainda mais, crie uma pasta .vscode no seu projeto com um arquivo settings.json:

{
    "python.defaultInterpreterPath": ".venv/bin/python",
    "python.terminal.activateEnvInSelectedTerminal": true,
    "editor.formatOnSave": true
}
Enter fullscreen mode Exit fullscreen mode

5. Aliases Adicionais para Git e Docker

Para um workflow de alta performance, adicione estes aliases ao seu .zshrc. Eles reduzem comandos longos a poucas letras.

Para Git: 

alias gst="git status"
alias gcm="git commit -m"
alias gpl="git pull"
alias gps="git push"
alias gco="git checkout"
alias glog="git log --oneline --graph --all"
Enter fullscreen mode Exit fullscreen mode

Para Docker: 

alias dps="docker ps"
alias dimg="docker images"
alias dcu="docker-compose up -d"
alias dcd="docker-compose down"
alias dlog="docker logs -f"
Enter fullscreen mode Exit fullscreen mode

Pronto para decolar! 🚀

Agora, sempre que tiver uma ideia nova, basta digitar:

start-python nome-da-ideia
Enter fullscreen mode Exit fullscreen mode

E focar apenas no código. O terminal criará tudo, isolará o ambiente e abrirá o VS Code já configurado para você.

Gostou dessa configuração? Deixe um comentário com qual ferramenta você usa para gerenciar seus ambientes Python!

Top comments (0)