Objetivos #
- Instalar o Python 3.13 no Windows 11 / 10
- Criar e gerenciar um ambiente virtual com
uvevenv - Conhecer os problemas frequentes e como resolvê-los
Pré-requisitos #
| Item | Detalhes |
|---|---|
| Permissões | Conta padrão é suficiente (liberamos scripts temporariamente com Set-ExecutionPolicy) |
| Shell | Windows PowerShell (busque por “PowerShell” no menu Iniciar) |
| Pasta de trabalho | Usaremos C:\projects\my-app como exemplo (mude se quiser) |
1. Instalar Python 3.13 #
Baixe o
Windows installer (64-bit)da página oficialRode o instalador e marque “Add python.exe to PATH”, depois clique em
Install NowConfirme a versão no PowerShell
py -3.13 --versionSe aparecer
Python 3.13.x, tudo certo. Casopynão seja reconhecido, feche e abra o PowerShell.
💡 Também dá para usar
winget install Python.Python.3.13, mas confira o PATH.
2. Instalar o uv #
uv é um gerenciador de pacotes rápido. Execute:
Set-ExecutionPolicy -Scope Process Bypass
iwr https://astral.sh/uv/install.ps1 -UseBasicParsing | iex
uv --version
Se o número da versão aparecer, deu certo. Caso contrário, reabra o PowerShell ou cheque se $Env:USERPROFILE\.local\bin está no PATH.
3. Criar a pasta do projeto e o ambiente virtual #
mkdir C:\projects\my-app
cd C:\projects\my-app
uv venv --python 3.13 .venv
O ambiente ficará na pasta .venv. Ative-o com:
.\.venv\Scripts\Activate.ps1
Quando o prompt mostrar (.venv), o ambiente está ativo. Use deactivate para sair.
✁ENão quer ativar? Use
uv run python script.pyque o ambiente é aplicado automaticamente.
4. Gerenciar bibliotecas #
uv pip install numpy pandas
uv pip list
uv pip sync requirements.txt
uv pip install: adiciona pacotesuv pip list: lista o que está instaladouv pip sync: replica o conteúdo derequirements.txt
5. Configurar o Visual Studio Code (opcional) #
- Abra o VS Code e selecione o interpretador Python na barra inferior
- Aponte para
.venv\Scripts\python.exepara ter autocomplete e debugging dentro do ambiente - Instale extensões como “Python”, “Pylance” e “Black Formatter” para facilitar o fluxo
6. Problemas comuns #
| Problema | Solução |
|---|---|
Set-ExecutionPolicy negado | Verifique permissões ou abra o PowerShell como administrador |
uv não encontrado | Abra um novo PowerShell / adicione $Env:USERPROFILE\.local\bin ao PATH |
Não consigo apagar .venv | Feche VS Code ou outros apps que estejam usando a pasta e tente novamente |
7. Limpeza #
- Sair do ambiente:
deactivate - Remover o ambiente: exclua a pasta
.venv - Registrar pacotes:
uv pip freeze > requirements.txt
Com Python 3.13 + uv prontos no Windows, siga para a próxima lição e mergulhe nos fundamentos da linguagem.