Python @property 装饰器：避免 TypeError: 'int' object is not callable 错误-Python教程-PHP中文网

Python @property 装饰器：避免 TypeError: 'int' object is not callable 错误

DDD

发布： 2025-07-03 23:04:20

原创

754人浏览过

python @property 装饰器：避免 typeerror: 'int' object is not callable 错误

本文深入探讨了Python中 @property 装饰器的正确使用方法，特别是如何避免常见的 TypeError: 'int' object is not callable 错误。文章将详细解释该错误发生的原因——尝试将属性（attribute）像方法（method）一样调用，并提供了访问属性的正确语法。此外，还将纠正 @property setter 的常见错误实现，指导读者构建健壮、符合Pythonic风格的类属性。

Python @property 装饰器简介

在Python中，@property 装饰器提供了一种优雅的方式来将类的方法转换为可像属性一样访问的特殊方法。它允许我们为实例属性定义 getter（获取器）、setter（设置器）和 deleter（删除器）方法，从而实现属性的封装和验证，而无需直接暴露内部数据。这使得类的接口更加简洁和直观，同时提供了对属性访问的精细控制。

例如，一个使用 @property 的 getter 方法，其行为就像一个普通属性：

class MyClass:
    def __init__(self, value):
        self._value = value

    @property
    def tenvalue(self):
        """这是一个getter方法，访问时就像访问属性一样"""
        return self._value * 10

obj = MyClass(10)
# 访问 tenvalue 就像访问普通属性一样，不需要括号
print(obj.tenvalue) # 输出 100

登录后复制

TypeError: 'int' object is not callable 错误解析

当你在使用 @property 装饰器定义的属性时，尝试像调用方法一样在其后面加上括号 ()，就会触发 TypeError: 'int' object is not callable 错误。

让我们分析原始代码中错误发生的原因：

立即学习“Python免费学习笔记（深入）”；

class MyClass:
    # ... (省略其他代码)
    @property
    def tenvalue(self):
        return self._value * 10
    # ... (省略其他代码)

obj = MyClass(10)
# ...
obj.tenvalue() # 错误发生在这里

登录后复制

属性访问而非方法调用： tenvalue 被 @property 装饰，这意味着它是一个属性，而不是一个普通的方法。当你写 obj.tenvalue 时，Python会执行 tenvalue 的 getter 方法 (return self._value * 10)，并返回其结果。
返回值为整数： 在 obj = MyClass(10) 的例子中，obj.tenvalue 的 getter 方法会返回 10 * 10 = 100。
尝试调用整数： 此时，表达式 obj.tenvalue() 实际上变成了 100()。由于 100 是一个整数（int 类型），而不是一个可调用的对象（如函数或方法），Python会抛出 TypeError: 'int' object is not callable 错误。

简而言之，@property 的目的是让你能够以属性（attribute）的方式访问一个计算值，而不是以方法（method）的方式去调用它。

正确使用 @property

正确访问 @property 装饰的属性，只需要像访问普通实例属性一样，不加括号即可：

obj = MyClass(10)
# 正确访问方式：直接引用属性名
print(obj.tenvalue) # 输出 100

登录后复制

@property Setter 的常见陷阱与最佳实践

除了 getter 的使用，@property 还允许我们定义 setter 方法，用于控制属性的赋值行为。原始代码中的 setter 实现存在一些问题，下面我们来分析并提供最佳实践。

1. Setter 的作用

setter 方法的目的是在属性被赋值时执行特定的逻辑，例如数据验证、类型转换或更新内部状态。它不应该有返回值，因为其主要作用是修改对象的状态。

2. 原始 Setter 的问题分析

原始代码中的 setter 如下：

@tenvalue.setter
def tenvalue(self, nv: int):
    self.name = nv # 问题1：错误地设置了不存在的 'name' 属性
    return nv * 10 # 问题2：setter 不应有返回值，且此返回值被忽略

登录后复制

问题1：错误的属性赋值 (self.name = nv)@property 装饰器通常用于封装一个内部的“私有”属性（通常以 _ 开头命名，例如 _value）。setter 的职责是更新这个内部属性，而不是创建或修改一个不相关的 name 属性。正确的做法应该是修改 _value。
问题2：Setter 的返回值 Python 的 setter 方法在执行完毕后，其返回值会被完全忽略。因此，return nv * 10 这行代码没有任何实际作用。setter 的核心功能是修改对象内部的状态，而不是返回一个新值。

3. 属性赋值时的 Typo 陷阱

原始代码中还存在一个容易被忽视的 typo：

obj.tenvalues = 22 # 注意这里是 'tenvalues'，多了一个 's'

登录后复制

这里将 obj.tenvalues 赋值为 22。由于 MyClass 中并没有定义名为 tenvalues 的属性或 @property，Python 会在 obj 实例上动态地创建一个新的属性 tenvalues 并赋值为 22。这不会触发 tenvalue 属性的 setter，因为属性名不匹配。

完整示例与最佳实践

下面是一个修正后的 MyClass 定义，展示了 @property 的正确 getter 和 setter 实现，以及如何正确使用它们：

class MyClass:
    def __init__(self, value):
        self._value = value # 内部私有属性，通常以单下划线开头

    def show(self):
        """显示内部值的方法"""
        print(f"当前内部值: {self._value}")

    @property
    def tenvalue(self):
        """
        tenvalue 的 getter 方法：
        访问时如 obj.tenvalue，返回 _value 的10倍。
        """
        print(f"正在获取 tenvalue...")
        return self._value * 10

    @tenvalue.setter
    def tenvalue(self, new_ten_value: int):
        """
        tenvalue 的 setter 方法：
        当 obj.tenvalue = X 被调用时执行。
        负责根据传入的“10倍值”更新内部 _value。
        """
        print(f"正在设置 tenvalue 为 {new_ten_value}...")
        if not isinstance(new_ten_value, (int, float)):
            raise TypeError("tenvalue 必须是数字类型")
        # 将传入的10倍值转换回原始值并更新 _value
        self._value = int(new_ten_value / 10)
        print(f"内部 _value 已更新为 {self._value}")

# 实例化对象
obj = MyClass(10)
obj.show() # 输出: 当前内部值: 10

# 访问 tenvalue 属性 (触发 getter)
print(f"obj.tenvalue = {obj.tenvalue}") # 输出: 正在获取 tenvalue... obj.tenvalue = 100

# 修改 tenvalue 属性 (触发 setter)
# 假设我们想让内部 _value 变为 22，那么传入的 tenvalue 应该是 220
obj.tenvalue = 220
obj.show() # 输出: 正在设置 tenvalue 为 220... 内部 _value 已更新为 22 当前内部值: 22

# 再次访问 tenvalue 属性，确认值已更新
print(f"obj.tenvalue = {obj.tenvalue}") # 输出: 正在获取 tenvalue... obj.tenvalue = 220

# 尝试错误调用方式 (会导致 TypeError)
try:
    obj.tenvalue()
except TypeError as e:
    print(f"捕获到错误: {e}") # 输出: 捕获到错误: 'int' object is not callable

登录后复制