Módulo gratuito 1h 30m

F02 — Preparando a bancada: Python, Git e venv no Windows

Instale Python e Git no Windows, crie um ambiente virtual (venv), fixe versões no requirements.txt e diagnostique os erros mais comuns lendo a mensagem.

Lessons and interactive exercises are delivered in Brazilian Portuguese (pt-BR). Switch to Portuguese version.

Em uma frase: Antes de cozinhar, você monta a bancada: fogão (Python), caixa de ferramentas própria (venv) e caderno de receitas (Git).
Pergunta guia: O que exatamente eu instalo, em que ordem, e como sei que deu certo antes de escrever uma linha de código?

Vídeo da lição F02 · NotebookLM

Material multimídia da lição

Preparando a bancada no Windows (Python, venv e Git)

Passo a passo em vídeo mostrando por que usar ambiente virtual (venv), fixar versões no requirements.txt e evitar erros clássicos de PATH.

Vídeo MP4
Passo 1 · Antes de ler: preveja

Tente responder antes de abrir o gabarito

Errar uma previsão mostra exatamente onde está a lacuna. Chute mentalmente ou no papel antes de revelar a resposta do professor.

1. Você instala o Django direto no Python global do PC para dois projetos (um precisa do Django 4, outro do Django 5). O que acontece?

2. Para que serve o arquivo requirements.txt?

3. Você digita 'python --version' no Windows e dá erro. Significa que o Python não está instalado?

1. Cinco comandos do terminal (PowerShell) que bastam

Quase todo erro de iniciante no terminal é estar na pasta errada. Antes de rodar qualquer comando, confira onde você está com pwd.

ComandoO que fazAssociação
pwdMostra em qual pasta você estáEm que sala estou?
lsLista os arquivos e pastas aqui dentroOlhar a prateleira
cd pastaEntra em uma pastaIr para outra sala
cd ..Volta uma pasta acimaVoltar uma sala
mkdir nomeCria uma pasta novaMontar uma prateleira

2. Criando o ambiente virtual (.venv) e travando versões

Ao instalar o Python no Windows pelo instalador oficial (python.org), marque obrigatoriamente a caixa 'Add python.exe to PATH'. Depois, crie a pasta do projeto, gere o ambiente virtual e instale as versões testadas:

Sequência exata executada no PowerShell (Windows 11)

mkdir mini-loja
cd mini-loja
py -3.12 -m venv .venv
.venv\Scripts\python -m pip install --upgrade pip
.venv\Scripts\python -m pip install django==5.1.4 djangorestframework==3.15.2
.venv\Scripts\python -m pip freeze > requirements.txt
.venv\Scripts\python -m django --version
  • py -3.12 -m venv .venv — Cria a caixa de ferramentas isolada na pasta .venv
  • .venv\Scripts\python ... — Garante que você usa o Python de dentro da caixa, sem depender de ativação
  • django==5.1.4 — Versão fixa: evita que uma atualização futura quebre o código da aula
  • pip freeze > requirements.txt — Salva a lista exata de pacotes instalados
Quebre de propósito

Esquecer o .venv e tentar rodar django fora da caixa

Experimento: Em uma pasta nova sem ambiente virtual, digite django-admin --version no PowerShell.

O que falha: O Windows responde que o termo 'django-admin' não é reconhecido como nome de cmdlet ou programa.

Por que a regra existe: As bibliotecas instaladas dentro do .venv só existem lá dentro. Sempre prefixe com .venv\Scripts\python (ou ative o ambiente).

Armadilhas comuns (errado × certo)

ErradoCertoPor quê
Usar 'pip install django' sem versão fixaUsar 'django==5.1.4' e registrar em requirements.txtSem versão fixa, outro computador pode instalar uma versão incompatível meses depois.
Ignorar 'Add python.exe to PATH' no instaladorMarcar a opção no instalador e testar com py --versionSem PATH ou launcher py, o terminal não encontra o executável.
Mão na massa

Exercício com pista e gabarito

Se você baixar um projeto Django do GitHub que já tem um requirements.txt, quais 3 comandos montam a bancada dele no Windows?

Ver pista

Criar o venv, atualizar o pip (opcional) e instalar a partir do arquivo com -r.

Ver gabarito

1) py -3.12 -m venv .venv 2) .venv\Scripts\python -m pip install -r requirements.txt 3) .venv\Scripts\python manage.py --version

Quiz da lição

Quiz com explicação de cada erro

Por que criamos um ambiente virtual (.venv) para cada projeto Python?
O que significa 'django==5.1.4' no requirements.txt?
Revisão espaçada · 1, 3 e 7 dias

Fichas de revisão (clique para virar)

Se você só lembrar de 3 coisas desta lição:
  • Confira sempre em que pasta você está (pwd) antes de rodar comandos.
  • Cada projeto ganha seu próprio .venv para evitar conflito de versões.
  • Trave as versões testadas no requirements.txt — nunca envie .venv para o Git.
Apoio rápido · 44 termos

Glossário de Fundamentos (A–Z)