如何在Python类外部让方法像@property属性一样工作？

算力阿峰

2026-5-22

在Python模块级使用@property及其setter

嘿，这个问题问得挺实用的——完全可以把@property和它的setter扩展到模块级的环境中，只是因为模块和类的上下文略有不同，写法上需要注意一点细节，下面我给你拆解清楚：

核心原理

@property本质是一个实现了描述器协议的类，它的作用是把函数包装成一个可访问的属性对象。在模块里，我们可以直接用它来封装模块级的变量，逻辑和类里的用法基本一致，唯一的区别是模块级变量需要用global声明来修改。

示例实现

直接上代码，对应你想要的模块级写法：

# 模块级的私有变量，用下划线标识约定为内部使用
_bar = None

# 定义getter：用@property装饰模块级函数
@property
def bar():
    return _bar

# 定义setter：使用@property生成的属性对象的setter装饰器
@bar.setter
def bar(value):
    # 必须声明global，否则Python会把_bar当成函数内的局部变量
    global _bar
    _bar = value

测试验证

你可以在同一个模块或者导入该模块后测试这个属性：

# 测试读取
print(bar)  # 输出: None

# 测试赋值
bar = "这是模块级的property属性"
print(bar)  # 输出: 这是模块级的property属性

进阶用法：添加验证逻辑

和类里的@property一样，你也可以在模块级的setter里添加输入验证，比如限制变量类型或范围：

_bar = 0

@property
def bar():
    return _bar

@bar.setter
def bar(value):
    global _bar
    if not isinstance(value, int) or value < 0:
        raise ValueError("bar必须是非负整数")
    _bar = value

如果尝试赋值bar = -5，就会抛出ValueError，完美实现模块级变量的访问控制。