Desarrollo Web

Instalación y configuración de Python paso a paso (Windows, macOS y Linux)

Jairo
6 min de lectura
En mi experiencia, Python es de los lenguajes más amables para empezar: comprensible, versátil y súper útil para IA/ML, web con Flask/Django y automatización. Vamos por partes y sin saltos.

1) Antes de instalar: qué versión elegir y dónde descargarla

Qué versión: hoy todo gira en torno a Python 3.x. Para empezar, usa la versión estable más reciente de la rama 3 (evita betas).
De dónde: instalador oficial de python.org (Windows/macOS), Microsoft Store (Windows, para principiantes), Homebrew (macOS), y gestor del sistema (apt/dnf en Linux). Si vas a hacer data science pesado, Anaconda puede ser práctica.

Checklist rápido

  •  Confirmar si ya tienes Python:
    • Windows/macOS/Linux: python --version o python3 --version
  •  Si hay dos comandos (python y python3), toma nota: lo aclaramos luego.
  •  Decide el método (instalador vs Store vs Homebrew vs Anaconda).

Mini-consejo personal: cuando monté entornos de ML, me funcionó mejor usar instalador oficial + venv/pipx. Para principiantes absolutos en Windows, la Store es sencilla, pero limita un poco.

Microsoft Store vs instalador oficial (cuándo usar cada uno)

  • Store (Windows): fácil, actualiza solo. Ideal para empezar y no romper nada.
  • Instalador oficial: más control (agregar al PATH, features opcionales). Lo prefiero en proyectos “serios”.

Homebrew en macOS, gestores en Linux y Anaconda

  • Homebrew (macOS): brew install python → actualización simple.
  • Linux: apt (Ubuntu/Debian) o dnf (Fedora) mantienen seguridad e integración del sistema.
  • Anaconda: te instala Python + cientos de libs de ciencia de datos. Es pesado, pero práctico para data science.

2) Instalar Python en Windows 10/11 (método recomendado)

Descarga, opciones del instalador y agregar al PATH

  1. Descarga el instalador de python.org (x64).
  2. Marca “Add Python to PATH”.
  3. Elige “Customize installation” si quieres pip, IDLE, documentación y py launcher.
  4. Finaliza y cierra.

Verificar instalación y resolver “python vs python3”

Abre PowerShell o CMD:

python --version
py --version
python -c "print('Hola desde Python!')"

Si python no existe pero py sí, puedes usar py -3:

py -3 --version
py -3 -c "print('Ok, funciona')"

Alternativa: Microsoft Store

Abre la Store, busca “Python 3”. Instala. Verifica con python --version. Si algo falla, usa py -3.

Tip personal: en Windows suelo usar py para elegir versión (py -3.11, py -3.12…), es muy cómodo.

3) Instalar Python en macOS (instalador oficial y Homebrew)

Evitar conflictos con la versión del sistema

macOS puede traer una versión antigua; evita tocarla. Trabaja con una versión propia (instalador u Homebrew) aislada con venv.

Instalar con Homebrew y actualizar

# si no tienes brew: https://brew.sh
brew update
brew install python
python3 --version
python3 -c "print('Hola macOS')"

Alias útil (opcional):

# añade a tu ~/.zshrc
alias python=python3
alias pip=pip3

Verificación y solución de errores comunes

  • SSL/certificados: en macOS antiguos, reinstala certificados con el script “Install Certificates.command” incluido con Python.
  • Permisos: ante errores de permisos con pip, usa venv (abajo) para instalar paquetes por proyecto.

4) Instalar Python en Linux (Ubuntu/Debian/Fedora)

# Ubuntu/Debian
sudo apt update
sudo apt install -y python3 python3-pip python3-venv
python3 --version

# Fedora
sudo dnf install -y python3 python3-pip python3-virtualenv
python3 --version

Mantener varias versiones con pyenv

pyenv te permite tener Python 3.10/3.11/3.12 en paralelo.

# requisitos típicos (Ubuntu)
sudo apt update && sudo apt install -y build-essential curl git \
zlib1g-dev libssl-dev libbz2-dev libreadline-dev libsqlite3-dev \
libffi-dev

# instalar pyenv
curl https://pyenv.run | bash

# añade a tu shell (~/.bashrc o ~/.zshrc):
export PATH="$HOME/.pyenv/bin:$PATH"
eval "$(pyenv init -)"
eval "$(pyenv virtualenv-init -)"

# usarlo
pyenv install 3.12.6
pyenv global 3.12.6
python --version

En mi caso, pyenv fue clave para alternar entre proyectos con requisitos distintos.

5) Configuración esencial tras la instalación (lo que nadie te cuenta)

pip, pipx y venv: qué hace cada uno

  • pip: instala paquetes dentro del entorno activo.
  • venv: crea entornos por proyecto, aislando dependencias.
  • pipx: instala apps de Python globalmente pero aisladas (ideal para CLIs como black, ruff, poetry).

Crear y activar entornos virtuales

# crear venv
python -m venv .venv

# activar
# Windows (PowerShell)
.venv\Scripts\Activate.ps1
# macOS/Linux
source .venv/bin/activate

# instalar dependencias del proyecto
pip install requests
python -c "import requests; print('ok requests', requests.__version__)"

pyproject.toml, requirements.txt y estructura mínima

Estructura base:

mi_proyecto/
├─ .venv/
├─ src/
│  └─ app.py
├─ tests/
├─ requirements.txt
└─ pyproject.toml   (opcional)

Genera requirements.txt:

pip freeze > requirements.txt

Consejo personal: para proyectos de mediano tamaño, pyproject.toml con Poetry hace más limpio el manejo de dependencias:

pipx install poetry
poetry init
poetry add requests
poetry run python src/app.py

6) Elegir y preparar tu IDE de Python

VS Code + extensiones clave

  • Extensiones: Python, Pylance, Ruff, Black Formatter, Jupyter.
  • Configuración recomendada (settings.json):
{
  "python.defaultInterpreterPath": ".venv/bin/python",
  "python.analysis.typeCheckingMode": "basic",
  "editor.formatOnSave": true,
  "python.formatting.provider": "black",
  "ruff.lint.run": "onSave"
}

Atajo útil: Ctrl+Shift+P → “Python: Select Interpreter” y elige el de .venv.

PyCharm (Community/Professional)

  • Community: ideal para empezar en Python puro.
  • Professional: añade soporte web y de bases de datos (Django/Flask a tope).
    Cuando trabajé con Django, los asistentes de PyCharm para settings.py, migraciones y plantillas ahorran tiempo.

Formateo, linting y depuración

  • Black (formateo): pipx install black → black .
  • Ruff (lint): pipx install ruff → ruff check .
  • Debug: en VS Code, crea .vscode/launch.json y usa breakpoints.

7) Primer script y comprobación del entorno

“Hola, Python” en archivo

src/app.py:

print("Hola, Python 👋")

Ejecuta:

python src/app.py

Entrada de usuario y módulos estándar

# src/cli.py
import sys
nombre = input("¿Tu nombre? ")
print(f"Hola, {nombre}. Versión de Python:", sys.version)

Mini-ejemplo web con Flask (ideal si vienes de desarrollo web)

pip install flask

src/web.py:

from flask import Flask
app = Flask(__name__)

@app.get("/")
def home():
    return {"msg": "Hola desde Flask"}

if __name__ == "__main__":
    app.run(debug=True)

Corre:

python src/web.py
# abre http://127.0.0.1:5000

Comentario personal: cuando probé Flask para prototipos, la rapidez para levantar endpoints me ganó.

Mini-ejemplo con Django (estructura real)

pip install django
django-admin startproject mi_sitio .
python manage.py runserver

Ahora ve a http://127.0.0.1:8000.
 Para una app:

python manage.py startapp blog

8) Solución de problemas frecuentes

PATH duplicado o mezclado

  • En Windows, desinstala versiones viejas y reinstala marcando “Add to PATH”. Usa py -0p para listar intérpretes.
  • En macOS/Linux, evita sudo pip; usa venv. Si python apunta a otra cosa, crea alias o usa ruta absoluta de .venv.

pip no funciona / proxy / certificados

  • Actualiza pip: python -m pip install --upgrade pip.
  • Si estás tras proxy:
  • setx HTTP_PROXY http://usuario:pass@proxy:puerto
    setx HTTPS_PROXY https://usuario:pass@proxy:puerto
    
  • Certificados (macOS antiguos): re-instala certificados del bundle de Python.

Conflicto python / python3

  • Usa el que existe: python3. En Windows, prueba py -3.
  • En macOS/Linux, añade alias en ~/.zshrc o ~/.bashrc.

Desinstalar/actualizar de forma segura

  • Windows: Apps & Features → desinstala → reinstala limpio.
  • macOS (brew): brew upgrade python.
  • Linux: usa el gestor del sistema o pyenv para versiones paralelas.

9) Recursos y siguientes pasos (gratuitos y oficiales)

  • Documentación oficial de Python y tutorial.
  • Guías de Flask/Django.
  • Extensiones VS Code y atajos de depuración.
  • Practica con scripts de automatización (renombrar archivos, leer CSV/JSON) y pequeños proyectos (API Flask, blog Django, script ETL).

Ejemplos de programación adicionales (copy-paste friendly)

Automatización: renombrar archivos por patrón

# src/renombrar.py
import os, re, pathlib
carpeta = pathlib.Path("docs")
for ruta in carpeta.glob("*.txt"):
    nuevo = re.sub(r"\s+", "_", ruta.name.lower())
    ruta.rename(ruta.with_name(nuevo))
print("Listo ✅")

Consumo de API y manejo de JSON

# src/api.py
import requests
r = requests.get("https://jsonplaceholder.typicode.com/todos/1", timeout=10)
r.raise_for_status()
data = r.json()
print(data["title"])

Mini-demo de data (pandas) en entorno aislado

pip install pandas

# src/data_demo.py import pandas as pd df = pd.DataFrame({"x":[1,2,3], "y":[10,20,30]}) df["z"] = df["x"] * df["y"] print(df)

Esqueleto de pruebas unitarias (pytest)

pip install pytest

tests/ └─ test_math.py
# tests/test_math.py def sumar(a, b): return a + b def test_sumar(): assert sumar(2, 3) == 5
pytest -q

Conclusión

Con esto tienes Python instalado y configurado de forma profesional, un IDE listo y varios ejemplos prácticos para romper el hielo: desde “Hola, Python” hasta un endpoint en Flask o un proyecto Django. Tal como comentabas, Python es excelente para empezar y a la vez es pieza clave en IA, web y automatización. La clave es trabajar siempre en entornos virtuales y mantener ordenadas las dependencias.

FAQs

¿Microsoft Store o instalador? Store para empezar rápido; instalador para control fino (PATH, features).
¿pip, pipx o conda? pip + venv cubre la mayoría. pipx para CLIs globales. conda para data science pesado o entornos con librerías de sistema.
¿VS Code o PyCharm? VS Code es ligero y extensible; PyCharm brilla en proyectos grandes (Django, refactors potentes).


Python

Jairo

Comentarios (0)

No hay comentarios aún. ¡Sé el primero en comentar!

Envíame un comentario