Instal·lar Python i configurar el teu entorn de treball

Configurar bé el teu entorn de Python no és opcional. Si fas servir el Python del sistema, instal·les paquets globalment, i programes des d’un editor sense autocompletat ni control de dependències, tard o d’hora acabaràs tenint problemes. Aquesta guia t’ensenya a muntar un entorn net, funcional i escalable per programar amb Python de forma seriosa.

1. Instal·lar Python correctament

A Linux

Python normalment ja ve preinstal·lat:

python3 --version

No intentis actualitzar Python des del sistema directament. Fes servir pyenv si necessites altres versions.

A macOS

Fes servir Homebrew:

brew install python

T’instal·la python3 i pip3 de forma neta.

A Windows

Descarrega Python des de python.org. A l’ instal·lador:

1. Marca “Add Python to PATH”
2. Fes servir l’opció “Install Now”

Comprova:

python --version

També pots instal·lar-lo des de la Microsoft Store, però pot ser més limitat per a projectes reals.

2. Entorns virtuals (venv): obligatoris

Un entorn virtual és un Python aïllat del sistema. No instal·les paquets globalment.

python -m venv venv

Activació

1. Linux/macOS:

source venv/bin/activate

• Windows:

.\venv\scripts\activate

Amb l’entorn activat, pots instal·lar paquets:

pip install requests

I després guardar dependències:

pip freeze > requirements.txt

3. Consola interactiva

Pots provar codi directament amb:

python

Però és limitat. Fes servir IPython per a una experiència molt millor:

pip install ipython
ipython

Avantatges:

1. Autocompletat amb Tab
2. Historial
3. Sortides acolorides
4. Suport per a “màgias” útils (%timeit, %run, etc.)

4. Estructura mínima de carpetes

No llancis els teus scripts en carpetes soltes. Crea una estructura bàsica:

El_meu_projecte/
├── venv/
├── main.py
├── utils.py
├── requirements.txt
└── README.md

Per a projectes més grans:

El_meu_projecte/
├── src/
│ └── el_meu_modul/
│       ├── __init__.py
│       ├── core.py
├── proves/
│ └── test_core.py
├── pyproject.toml
├── README.md
├── requirements.txt
└── .gitignore

5. Editors de text i entorns de desenvolupament

Code VS

1. Lleuger, multiplataforma, configurable
2. Terminal integrada, depuració, autocompletat, entorns virtuals
3. Extensions clau:
   1. Python (oficial de Microsoft)
   1. Pylance (tipat ràpid)
   1. Negre, isort, ruff

Obre la paleta (Ctrl+Shift+P) i tria “Python: Select Interpreter” per activar el teu entorn virtual.

Thonny

Perfecte per als que comencen:

1. Instal·lador que inclou Python
2. Botó “Run” simple
3. Reordenació pas a pas visual

Menys útil a llarg termini, però excel·lent per a primers passos.

PyCharm

Un IDE complet (com Eclipse o IntelliJ):

1. Autocompletat, refactorització, tests, control de versions, debugger gràfic
2. Versió Community (gratis) i Professional (de pagament)

Pros:

1. Molt complet
2. Refactoritzacions potents
3. Entorns virtuals integrats

Contres:

1. Pesat
2. Algunes funcions clau només en la versió de pagament

Ideal per a projectes mitjans i grans.

JupyterLab / Notebooks

Per a ciència de dades, ensenyament o prototips:

pip instal·lar jupyterlab
jupyter lab

T’obre un entorn al navegador per executar codi per cel·les. Barreja Markdown i Python. Molt útil per explorar dades i mostrar resultats de forma ordenada.

6. Altres editors

1. Geany: lleuger, per a màquines lentes
2. Sublim Text: ràpid, però moltes funcions depenen de plugins
3. Spyder: orientat a científics, similar a MATLAB
4. Kate / Gedit: simples, si només vols editar sense IDEs

7. Linters i formatejadors: codi net o mort

És molt fàcil escriure codi Python que funcioni però sigui difícil de llegir o mantenir. Per evitar-ho, fa servir eines automàtiques des de l’inici.

black

Formatejador de codi. No es discuteix amb ningú: aplica el seu propi estil.

pip install black
black 

Exemple:

# abans
def suma ( a , b ) : return a+b

# després de black
def suma(a, b):
    return a + b

---

isort

Ordena automàticament els imports per blocs i ordre alfabètic.

pip install isort
isort 

ruff

Llanter ultraràpid. Combina funcionalitats de flake8, pylint, mccabe, pycodestyle, etc.

pip install ruff
ruff check 

També pot autofixar molts problemes amb:

ruff check . --fix

Recomanat fins i tot en projectes grans per la seva velocitat.

8. Alternatives modernes per a gestionar projectes

poetry: l’ opció moderna i coherent

Reemplaça a venv, pip, requirements.txt i setup.py. Tot integrat.

pip install poetry
poetry new el_meu_projecte
cd el_meu_projecte
poetry add requests

Crea i gestiona automàticament un entorn virtual. Fa servir pyproject.toml com a únic arxiu de configuració.

Avantatges:

1. Control de dependències clar
2. Versionat semàntic
3. Entorns virtuals automàtics
4. Publicació a PyPI

Ideal per als que volen flux net sense arxius solts.

pyenv: múltiples versions de Python

Permet tenir diverses versions de Python en el mateix sistema sense conflictes.

pyenv install 3.12.3
pyenv global 3.12.3

També pots definir versions locals amb:

pyenv local 3.11.7

Útil per a:

1. Provar codi en diferents versions
2. Evitar conflictes amb el Python del sistema
3. Treballar amb projectes heretats

Requereix compilar Python des de font, però val la pena.

Condat: per a ciència de dades i dependències natives

Ideal per a entorns amb biblioteques C complicades (NumPy, SciPy, OpenCV…).

conda create -n analisi python=3.11 pandas matplotlib
conda activate analisi

Avantatges:

1. Entorns aïllats
2. Instal·lació ràpida de paquets binaris complexos
3. Molt usat en investigació científica

Contres:

1. Pesa més
2. Pot generar conflictes amb pip si es barreja sense cura

9. Saber que el teu entorn està ben configurat

Fes aquest checklist:

• El teu projecte té estructura de carpetes (no arxius solts)
• Tens un entorn virtual activat
• Fas servir pip freeze o pyproject.toml per definir dependències
• El teu editor reconeix l’entorn i ofereix autocompletat
• Pots executar python main.py des de la terminal sense errors
• Tens llanters o formatejadors actius (black, ruff, isort)
• No tens paquets instal·lats globalment que no haurien d’estar

10. Bones pràctiques mínimes des del dia 1

1. No nomenis els teus scripts test.py, email.py, os.py, etc.
   Xocaran amb mòduls estàndard de Python.
2. No instal·lis paquets amb sudo pip install.
   Fes sempre entorns virtuals.
3. No posis codi al directori arrel sense carpeta del projecte.
4. Documenta el teu codi.
   Encara que sigui només per a tu, deixa un README.md que expliqui què fa el projecte i com fer-lo servir.
5. Versiona el teu codi amb Git.
   Encara que no vagis a compartir-ho, Git et salva d’errors i permet tornar enrere.

11. Quin editor fer anar segons el teu perfil?

Perfil	Opció recomanada
Principiant total	Thonny
Usuari general o web	VS Code
Projecte mitjà/gran	Comunitat PyCharm
Ciència de dades / prototips	JupyterLab + VS Code
Múltiples versions de Python	VS Code + pyenv
En màquines lentes	Geany / Text sublim

12. Automatitza tasques repetitives

Fes servir make, scripts Bash o eines com nox, tox, invoke, doit per definir tasques com:

1. Executar tests
2. Aplicar formatejadors
3. Generar documentació
4. Instal·lar dependències

Exemple amb Makefile:

lint:
        ruff check .

format:
        black .
        isort .

test:
        pytest

I ho executes així:

make lint
make format
make test

Conclusió

Tenir un entorn ben muntat a Python no és complicat, però sí essencial. Instal·la Python de forma controlada, fa servir sempre entorns virtuals, organitza el teu codi des del principi i tria un editor que t’ajudi, no que desordeix.

Un cop tinguis això llest, ja pots centrar-te a aprendre la sintaxi, dominar les estructures, entendre els mòduls i llibreries estàndard, i aprofundir en testing, disseny i arquitectura. Però tot això és inútil si el teu entorn és un caos.