能否为Python模块变量使用@property属性替代实例属性？

你的问题在于直接在模块级别使用@property装饰器——这个装饰器是为类的实例方法设计的，模块对象无法识别它生成的属性描述符，所以达不到预期的getter/setter效果。

要实现你想要的模块属性式访问，同时保留赋值时的日志逻辑，可以用类封装配置，再让模块代理类实例的属性。具体实现如下：

config.py #

import logging

# 初始化日志配置（可根据需求调整级别、格式）
logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)

class _Config:
    def __init__(self):
        self._test = False

    @property
    def test(self):
        return self._test

    @test.setter
    def test(self, new_value):
        self._test = new_value
        logger.info(f'config: test is set to {new_value}')

# 创建配置实例
_config = _Config()

# 让模块代理实例的属性访问
def __getattr__(name):
    return getattr(_config, name)

def __setattr__(name, value):
    if name.startswith('_'):
        # 保留模块自身私有属性的直接赋值逻辑
        super().__setattr__(name, value)
    else:
        # 公开属性转发到配置实例处理
        setattr(_config, name, value)

main.py #

import config

config.test = True  # 输出: config: test is set to True
print(config.test)  # 输出: True

原理说明 #

1. 用_Config类封装配置属性和对应的getter/setter逻辑，这是@property装饰器的标准用法，能正常触发赋值时的日志操作。
2. 通过模块的__getattr__和__setattr__魔法方法，把对模块属性的访问转发到_Config实例上，外部代码可以像操作普通模块属性一样直接访问config.test。
3. 对模块私有属性（以_开头）保留直接赋值逻辑，避免干扰模块自身的内部变量。

内容的提问来源于stack exchange，提问作者Valentin Fabianski