Buenas prácticas en Python: escribe código limpio, legible y profesional

Escribir código funcional es solo el primer paso. Escribir código **limpio, mantenible y profesional** es lo que diferencia a un programador intermedio de uno avanzado. En esta guía aprenderás las mejores prácticas recomendadas por la comunidad Python y el estilo oficial PEP 8.

1. Nombres de variables y funciones

Usa nombres descriptivos y estilo snake_case.

# Bien
total_ventas = 150

# Mal
tv = 150

2. Organización del código

Divide tu código en funciones, módulos y paquetes. Evita archivos enormes y difíciles de leer.

# archivo: operaciones.py
def sumar(a, b):
    return a + b

3. Comentarios y docstrings

Usa comentarios solo cuando sea necesario. Para funciones y clases, usa docstrings.

def sumar(a, b):
    """Devuelve la suma de dos números."""
    return a + b

4. Evitar duplicación de código

Si repites código, conviértelo en una función reutilizable.

# Mal
print(10 * 2)
print(15 * 2)

# Bien
def doble(n):
    return n * 2

5. Uso correcto de excepciones

Captura solo las excepciones necesarias y muestra mensajes útiles.

try:
    resultado = 10 / 0
except ZeroDivisionError:
    print("No puedes dividir entre cero")

6. Ejercicios

# tv -> total_ventas

def doble(n): return n * 2

def sumar(a, b):
    """Suma dos números."""

# archivo: utilidades.py

try:
    int("hola")
except ValueError:
    print("Error de conversión")

7. Mini‑proyecto: Refactorizar código desordenado

# Código original
a = 10
b = 20
print(a + b)
print(a * b)

# Código refactorizado
def sumar(a, b): return a + b
def multiplicar(a, b): return a * b

print(sumar(10, 20))
print(multiplicar(10, 20))

8. Preguntas frecuentes

¿Debo seguir PEP 8 siempre?

Sí, es el estándar oficial de estilo en Python.

¿Las buenas prácticas mejoran el rendimiento?

No siempre, pero mejoran la mantenibilidad.

Siguiente guía