capitulo_176

🛠️ 16.1 Instalando o Python no Windows

🎯 Objetivo

Configurar o ambiente de desenvolvimento Python no Windows, garantindo que o interpretador e o gerenciador de pacotes (pip) estejam acessíveis via terminal.

🏗️ Passo 1: Download e Instalação

O primeiro passo é acessar o site oficial: python.org/downloads. O site detectará automaticamente seu sistema operacional e oferecerá a versão mais recente do Python 3.

⚠️ Configuração Crucial: PATH

Ao executar o instalador, você verá uma tela com a opção: “Add Python 3.x to PATH”

Marque esta opção!

Se você esquecer de marcar o “Add to PATH”, o comando python não funcionará no seu terminal, obrigando você a configurar as variáveis de ambiente manualmente depois.

1. Marque o checkbox Add Python to PATH.
2. Clique em Install Now (Instalação padrão).
3. Aguarde a mensagem “Setup was successful”.

💻 Passo 2: Verificando a Instalação

Abra o Prompt de Comando (CMD) ou PowerShell e digite os seguintes comandos para validar:

# Verifica a versão do interpretador
python --version
 
# Verifica se o gerenciador de pacotes pip está funcional
pip --version

📦 Passo 3: Criando um Ambiente Virtual (venv)

Na engenharia de software moderna, nunca instalamos bibliotecas diretamente no Python global do sistema. Usamos Ambientes Virtuais para isolar as dependências de cada projeto.

Como criar e ativar seu ambiente:

No diretório do seu projeto, execute:

# 1. Cria a pasta do ambiente virtual (chamada 'venv')
python -m venv venv
 
# 2. Ativa o ambiente no Windows
.\venv\Scripts\activate

Ativação

Quando o ambiente está ativo, você verá o prefixo (venv) no seu terminal. Para sair, basta digitar deactivate.

📜 Passo 4: Gerenciando Dependências (requirements.txt)

Para que outros desenvolvedores (ou você mesmo no futuro) saibam quais bibliotecas seu projeto usa, utilizamos o arquivo requirements.txt.

# Instalando uma biblioteca de exemplo
pip install requests
 
# Gerando o arquivo de dependências
pip freeze > requirements.txt
 
# Instalando dependências de um projeto existente
pip install -r requirements.txt

✅ Resultado Esperado

Após seguir estes passos, você terá um ambiente profissional pronto para codificar, com isolamento de bibliotecas e controle de versões via pip.

🚨 Erros Comuns

Erro	Causa	Solução
'python' não é reconhecido...	O Python não foi adicionado ao PATH.	Reinstale marcando a opção ou adicione manualmente nas Variáveis de Ambiente.
Permission denied	O terminal não tem permissão de escrita.	Execute o CMD como Administrador ou use o venv para evitar mexer em pastas do sistema.

🔗 Próximo Capítulo

Agora que seu ambiente Windows está pronto, veja Instalação no Linux ou prossiga para o Primeiro Programa.

---

⬅️ Capítulo Anterior | Próximo Capítulo ➡️