Busca en todas las páginas de la documentación
Hábitos centrales que mantienen el código Python legible, correcto y mantenible antes de recurrir a frameworks o herramientas de datos. Trata esto como una lista de verificación de incorporación para cada nuevo módulo o repositorio.
pyproject.toml y un archivo de bloqueo (uv.lock). CI y clones reproducibles.requires-python en pyproject.toml.ruff check y ruff format en cada PR. Retroalimentación rápida de estilo y linting.snake_case, clases PascalCase, constantes UPPER.% y format() para código nuevo. Más claro y rápido.pathlib.Path en lugar de la manipulación de cadenas de os.path. Uniones seguras multiplataforma.def f(x=[])). Usa None y asigna en el interior.Decimal para dinero, no float binario. Evita sorpresas de 0.1 + 0.2 en facturación.encoding="utf-8" en toda la E/S de archivos de texto. Previene errores predeterminados de la plataforma.copy.deepcopy cuando la independencia importa. Las copias superficiales comparten listas internas.isinstance para comprobaciones de tipo, no type(x) is Cls en subclases. Amigable con el polimorfismo.append manuales al transformar secuencias. Legible y a menudo más rápido.match/case para ramificación estructural en diccionarios y dataclasses. Más limpio que cadenas if profundas.* en APIs públicas. Previene sitios de llamada ambiguos.if __name__ == "__main__":. Módulos importables sin efectos secundarios.python -m package.module. Importaciones relativas y __package__ correctos.from myapp.utils import x). Más claro que las relativas en árboles grandes.types compartidos. Falla rápido en tiempo de diseño cuando sea posible.json.py, types.py). Rompe importaciones misteriosamente.src/ para paquetes instalables. Previene importaciones accidentales desde la raíz del repositorio.No: configura ruff y concéntrate en la legibilidad. Automatiza los debates de formato.
Las constantes a nivel de módulo y la configuración en caché de solo lectura están bien. Los globales mutables complican las pruebas; prefiere la inyección.
Opcional para scripts desechables. Agrégalas cuando el script crezca o se convierta en un paquete.
match para estructura (claves de diccionario, eventos tipados). if para condiciones escalares simples.
Este manual fija uv 0.6+ como la ruta rápida predeterminada. Poetry sigue siendo válido para equipos que ya lo usan como estándar.
Comienza con módulos nuevos en flags opcionales strict; amplía gradualmente. Modelos Pydantic en los límites HTTP primero.
Mejor para transformaciones de map/filter. Usa un bucle for cuando los efectos secundarios o la ramificación compleja dominen.
print está bien para la experiencia de usuario de la CLI. Los servicios deben usar logging con campos estructurados; consulta la sección de errores-logging.
Comparaciones explícitas (is None, len(x) == 0) cuando los valores falsos pero válidos como 0 importan.
Entornos aislados con dependencias bloqueadas: todo lo demás falla sin instalaciones reproducibles.
Versiones de la Pila: Esta página fue escrita para Python 3.14.0 (estable 3.14, mantenimiento 3.13), FastAPI 0.115+, Django 5.2, Flask 3.1, Pydantic 2, PyTorch 2.6+, pandas 2.2+, Polars 1.x, ruff 0.9+, y uv 0.6+.
Revisado por Chris St. John·Última actualización: 16 jul 2026