ZetCode

Python 静态方法

最后修改于 2025 年 2 月 25 日

Python 中的静态方法是属于类而不是类的实例的方法。它们不需要访问实例或类，并且使用 @staticmethod 装饰器进行定义。静态方法通常用于实用函数、辅助方法和不依赖于实例或类状态的操作。本教程涵盖了 Python 中静态方法的创建、用法和实际示例。

静态方法是绑定到类而不是其实例的方法。它们不接受 self 或 cls 参数，这意味着它们无法访问或修改实例或类状态。静态方法使用 @staticmethod 装饰器进行定义，通常用于与类逻辑上相关但不依赖于其状态的实用函数或操作。

创建静态方法

此示例演示了如何在 Python 中创建和使用静态方法。

basic_static_method.py 
class MathUtils:
    @staticmethod
    def add(x, y):
        return x + y

result = MathUtils.add(10, 20)
print(result)  # Output: 30

add 方法是使用 @staticmethod 装饰器定义的静态方法。调用它不需要类的实例，并且可以直接使用类名进行访问。

实用类中的静态方法

此示例演示了静态方法如何在实用类中常用。

utility_class.py 
class StringUtils:
    @staticmethod
    def is_palindrome(s):
        return s == s[::-1]

    @staticmethod
    def reverse(s):
        return s[::-1]

print(StringUtils.is_palindrome("racecar"))  # Output: True
print(StringUtils.reverse("hello"))         # Output: olleh

静态方法通常用于实用类以对相关函数进行分组。在此示例中，StringUtils 类包含用于检查字符串是否为回文和反转字符串的静态方法。

类层次结构中的静态方法

此示例演示了静态方法如何在类层次结构中使用。

class_hierarchy.py 
class Animal:
    @staticmethod
    def make_sound():
        return "Generic animal sound"

class Dog(Animal):
    @staticmethod
    def make_sound():
        return "Woof!"

class Cat(Animal):
    @staticmethod
    def make_sound():
        return "Meow!"

print(Animal.make_sound())  # Output: Generic animal sound
print(Dog.make_sound())     # Output: Woof!
print(Cat.make_sound())     # Output: Meow!

静态方法可以在子类中被重写，从而实现多态行为。在此示例中，make_sound 方法在 Dog 和 Cat 子类中被重写。

用于工厂函数的静态方法

此示例演示了静态方法如何用作工厂函数。

factory_method.py 
class Point:
    def __init__(self, x, y):
        self.x = x
        self.y = y

    @staticmethod
    def from_tuple(coords):
        return Point(coords[0], coords[1])

    def __str__(self):
        return f"Point({self.x}, {self.y})"

p = Point.from_tuple((10, 20))
print(p)  # Output: Point(10, 20)

静态方法可以用作工厂函数来创建类的实例。在此示例中，from_tuple 方法从坐标元组创建 Point 对象。

用于数据验证的静态方法

此示例演示了静态方法如何用于数据验证。

data_validation.py 
class User:
    def __init__(self, username, email):
        self.username = username
        self.email = email

    @staticmethod
    def is_valid_email(email):
        return "@" in email

    @classmethod
    def create_user(cls, username, email):
        if not cls.is_valid_email(email):
            raise ValueError("Invalid email address")
        return cls(username, email)

user = User.create_user("alice", "alice@example.com")
print(user.email)  # Output: alice@example.com

# user = User.create_user("bob", "bobexample.com")  # Raises ValueError

在创建类的实例之前，可以使用静态方法进行数据验证。在此示例中，is_valid_email 方法在创建 User 对象之前会检查电子邮件地址是否有效。

使用静态方法的最佳实践

来源

Python 静态方法文档

在本文中，我们探讨了 Python 静态方法，并通过实际示例展示了它们在常见场景中的用法。

作者

我的名字是 Jan Bodnar，我是一名充满热情的程序员，拥有丰富的编程经验。我从 2007 年开始撰写编程文章。到目前为止，我已撰写了 1,400 多篇文章和 8 本电子书。我在编程教学方面拥有十多年的经验。

列出所有 Python 教程。