Métodos de Clase vs. Instancia vs. Estáticos

Python ofrece tres tipos de métodos. Los métodos de instancia operan sobre objetos, los métodos de clase sobre la clase (a menudo fábricas), y los métodos estáticos como funciones con espacio de nombres sin self o cls implícitos.

Receta

class User:
    def __init__(self, email: str) -> None:
        self.email = email
 
    def domain(self) -> str:
        return self.email.split("@", 1)[1]
 
    @classmethod
    def from_row(cls, row: dict[str, str]) -> "User":
        return cls(row["email"])
 
    @staticmethod
    def is_valid_email(email: str) -> bool:
        return "@" in email and "." in email.split("@", 1)[-1]

Cuándo usar esto:

• Constructores alternativos (from_json, from_env)
• Utilidades lógicamente agrupadas con la clase pero que no necesitan estado
• Métodos de fábrica heredados que respetan la cls de la subclase
• Métodos de clase para Enum/clases personalizadas que modifican el estado de la clase

Ejemplo de Trabajo

from datetime import datetime, timezone
 
class Event:
    def __init__(self, name: str, ts: datetime) -> None:
        self.name = name
        self.ts = ts
 
    def age_seconds(self, now: datetime | None = None) -> float:
        now = now or datetime.now(timezone.utc)
        return (now - self.ts).total_seconds()
 
    @classmethod
    def now(cls, name: str) -> "Event":
        return cls(name, datetime.now(timezone.utc))
 
    @classmethod
    def from_iso(cls, name: str, iso: str) -> "Event":
        ts = datetime.fromisoformat(iso.replace("Z", "+00:00"))
        return cls(name, ts)
 
    @staticmethod
    def normalize_name(name: str) -> str:
        return name.strip().lower()
 
class AdminEvent(Event):
    pass
 
if __name__ == "__main__":
    base = Event.now("deploy")
    admin = AdminEvent.now("promote")
    print(type(base), type(admin))
    print(Event.is_valid_email("a@b.com"))

Lo que esto demuestra:

• El classmethod now es un constructor alternativo
• AdminEvent.now devuelve AdminEvent porque cls es la subclase
• El método de instancia age_seconds usa el estado del objeto
• El staticmethod normalize_name no necesita ni self ni cls

Inmersión Profunda

Cómo Funciona

• Métodos enlazados - Los métodos de instancia enlazan self en el momento de la llamada.
• Descriptor classmethod - Pasa la clase como primer argumento automáticamente.
• Descriptor staticmethod - Sin argumento de primer elemento automático.
• Herencia - cls en classmethod es la clase real llamada (AdminEvent no Event).
• Acceso - Los métodos de clase pueden acceder a atributos de clase; los métodos de instancia a atributos de instancia.

Cuándo Usar Cada Uno

Notas de Python

# Patrón de classmethod estilo enum
class Money:
    def __init__(self, amount: int, currency: str) -> None:
        self.amount = amount
        self.currency = currency
 
    @classmethod
    def usd(cls, amount: int) -> "Money":
        return cls(amount, "USD")

Trampas

• staticmethod cuando se necesita classmethod - Una fábrica que devuelve cls falla en subclases con staticmethod. Solución: Usa classmethod para constructores polimórficos.
• classmethod accediendo a estado de instancia - No hay self disponible. Solución: Pasa la instancia explícitamente o usa un método de instancia.
• Función confusa a nivel de módulo - Un staticmethod que nunca toca la clase podría ser una función de módulo. Solución: Usa staticmethod solo cuando agrupes la API en el espacio de nombres de la clase.
• Orden de classmethod abstracto - Apila @classmethod y @abstractmethod según la documentación de la versión de Python.
• Llamar a classmethod en una instancia - Permitido pero inusual - todavía pasa la clase real.

Alternativas

Preguntas Frecuentes

Relacionado

• Propiedades y Descriptores - descriptores de métodos
• Dataclasses - patrones de construcción
• Herencia y MRO - cls en contexto MRO
• Enums - métodos de clase Enum

Versiones de Stack: 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+.