Capítulo 2, Ambiente
Instalando e importando o NumPy
Duas linhas deixam o NumPy pronto, e a maioria dos problemas de iniciantes vem de a instalação ter ido parar em um Python diferente do que você está usando.
Código deste capítulo: ambiente/cap02_instalacao.py
Instalar
O NumPy se instala como qualquer pacote Python, dentro de um ambiente virtual, como o curso de Python mostrou. Escolha a ferramenta que você usa:
uv init meu-projeto
cd meu-projeto
uv add numpy
O uv add cria o ambiente, instala o pacote e o registra no pyproject.toml. Para executar um arquivo no ambiente do projeto, use uv run arquivo.py.
O NumPy distribui versões já compiladas (wheels) para os sistemas e versões do Python mais comuns. Por isso a instalação leva segundos e não exige compilador.
Importar, e a convenção `np`
import sys
from pathlib import Path
import numpy as np
print("versão 2 ou superior:", int(np.__version__.split(".")[0]) >= 2)
print("onde está o NumPy:", Path(np.__file__).parent.name)
print("este Python existe no disco:", Path(sys.executable).exists())
versão 2 ou superior: True
onde está o NumPy: numpy
este Python existe no disco: True
O apelido np não é uma regra da linguagem, mas é uma convenção tão forte que toda documentação, todo tutorial e toda resposta na internet a assumem. Usar outro apelido só faz você traduzir o que lê.
Para ver como o seu NumPy foi construído (quais bibliotecas de álgebra linear ele usa, por exemplo), existe o show_config:
np.show_config()
Quando o import falha
O erro mais comum é instalar com o pip em um terminal e receber No module named 'numpy' no editor. Quase sempre isso significa que são dois Pythons diferentes: o do terminal recebeu o pacote, e o do editor (ou do notebook) não. Para descobrir qual Python está rodando e se ele enxerga o NumPy:
python -c "import sys; print(sys.executable)"
python -m pip show numpy
python -c "import numpy; print(numpy.__version__, numpy.__file__)"
| Sintoma | Causa provável | O que fazer |
|---|---|---|
No module named 'numpy' no editor | O editor usa outro interpretador | Selecione o interpretador do .venv do projeto |
No module named 'numpy' só no notebook | O kernel é de outro ambiente | Instale ipykernel no ambiente e escolha esse kernel |
| Versão inesperada | Dois ambientes com versões diferentes | Compare sys.executable nos dois lugares |
| Erro de instalação por falta de compilador | Versão do Python sem wheel disponível | Use uma versão do Python suportada pelo pacote |
A regra que me poupa tempo
Sempre use
python -m pipem vez depippuro. Assim opipé obrigatoriamente o do interpretador que você chamou, e o pacote cai no lugar certo.
Exercício 1
Um diagnóstico do ambiente
Escreva diagnostico() que devolva um dicionário com a versão do NumPy, a versão do Python (como tupla de dois números) e se o executável do Python existe no disco.