【python 基础】装饰器-平芜编程栈

前言：

一旦你在一个函数上方添加了@property，这个函数就不再是一个普通的“方法（Method）”了，它被转化成了一个属性对象（Property Object）/ 描述符（Descriptor）。

我们可以把这个过程拆解得更深一点，看看 Python 背后到底发生了什么：

1. 这种转化的本质

在 Python 内部，当你定义：

@property def segmap(self): return self._current_segmap

这等同于执行了：segmap = property(fget=segmap)

此时，segmap变成了一个特殊的容器。这个容器里装载了你定义的那个函数，并且自动拥有了几个“口袋”（方法）：

.getter
.setter
.deleter

2. 为什么需要这个“属性对象”？

如果它只是个普通函数，当你写cam.segmap = data时，Python 会直接把data覆盖掉你的函数，导致你的segmap函数消失。

但因为它是属性对象：

当你执行赋值(=) 时，Python 发现segmap是个属性对象，它不会去覆盖它，而是去翻segmap的口袋，寻找.setter里的逻辑。
如果你没定义.setter就去赋值，Python 会直接报错：AttributeError: can't set attribute。这就是为什么@property默认是只读的。

3. 验证一下：它是“对象”还是“函数”？

我们可以通过一段简单的代码来看看它的“真身”：

class Camera: @property def segmap(self): return "some data" # 注意：我们直接通过【类名】而不是【实例】去查看 print(type(Camera.segmap)) # 输出：<class 'property'> <-- 看！它已经不是 function 了，而是 property 类型

4. 举个例子：如果你改了名字

如果你把名字从segmap改成pizza，那么装饰器也必须跟着变：

class MyClass: @property def pizza(self): # 这里决定了属性对象的名字叫 pizza return self._sauce @pizza.setter # 注意！这里必须跟着叫 @pizza.setter def pizza(self, value): self._sauce = value

总结本质：装饰器property 就是为了改变函数为对象，让函数具备属性。所以对于装饰器的函数，

5.`@property`(Getter) 部分：禁止传参

当你写@property时，你是在定义一个“属性”。在 Python 的逻辑里，属性应该是直接获取的，而不应该是被“计算”出来的（需要输入参数的那种叫方法）。

错误写法：

@property def segmap(self, mode): # ❌ 报错！Getter 不能接受额外参数 return self._current_segmap

正确写法：

@property def segmap(self): # ✅ 只能有 self return self._current_segmap

为什么？因为你访问它时是写cam.segmap。这里没有任何括号()给你放参数的地方。

6.`@segmap.setter`部分：必须接受一个参数

虽然@property函数不能带参数，但对应的Setter 函数必须带且只能带一个参数（通常叫value）。

内部逻辑：当你写cam.segmap = [1, 0, 1]时，等号右边的整个[1, 0, 1]就会被 Python 解释器当作实参，自动传给 Setter 函数。

@segmap.setter def segmap(self, value): # 这个 value 接收等号右边的值 self._current_segmap = value

7. 如果我真的需要带参数怎么办？

如果你发现自己很想给segmap传参数（比如cam.get_segmap(mode='binary')），那么这个时候你就不应该使用@property。

你应该直接定义一个普通的方法（Method）：

场景	应该使用...	调用方式
不需要参数（直接拿取/修改）	`@property`	`a = cam.segmap`
需要参数（需要根据条件计算）	普通函数 (Method)	`a = cam.get_segmap(mode='raw')`