When to Use @staticmethod vs @classmethod in Python: A Practical Guide

1. Concept

Static method @staticmethod

It is a “tool function placed inside a class but not directly related to the class”, cannot access self or cls. In plain words, it is a regular function stored in the class namespace for organization.

Class method @classmethod

It is closer to the class itself. Its first parameter is cls, allowing access to class attributes and enabling “alternative constructors”. It deals with class‑level data rather than instance data.

2. Usage Scenarios

When to use @staticmethod

Use when the method logic is related to the class but does not need to access class or instance data. Typical examples are utility methods.

class MathUtils:
    @staticmethod
    def add(a, b):
        return a + b

    @staticmethod
    def is_prime(n: int) -> bool:
        if n < 2:
            return False
        return all(n % i for i in range(2, int(n**0.5) + 1))

These methods could be placed outside the class, but keeping them inside makes the code more organized.

When to use @classmethod

Use when you need to access or modify class attributes or create alternative constructors.

class DatabaseConnection:
    connection_count = 0

    def __init__(self, host, port):
        self.host = host
        self.port = port
        DatabaseConnection.connection_count += 1

    @classmethod
    def get_connection_count(cls):
        return cls.connection_count

    @classmethod
    def from_url(cls, url: str):
        """Factory method: initialize from a URL"""
        host, port = url.split(":")
        return cls(host, int(port))

Now you can create an instance via DatabaseConnection.from_url("127.0.0.1:3306"), making the code more elegant.

3. Summary

The core differences are:

A static method is completely independent of the class and its instances.

A class method is bound to the class but independent of any particular instance.

Understanding these distinctions lets you write cleaner, more maintainable Python code.