如何实现setter仅可调用一次的类属性，且符合Pythonic规范？

最优Pythonic实现：继承内置property类 #

该方案完全复用Python原生的描述符协议，是最符合Python设计习惯的实现，无需额外引入依赖，兼容性和可读性都最佳。

class OnceWriteProperty(property):
    def __set__(self, instance, value):
        attr_name = self.fget.__name__
        # 直接从实例字典判断是否已经赋值，避免触发自身的get逻辑
        if attr_name in instance.__dict__:
            raise AttributeError(f"属性 '{attr_name}' 仅允许被赋值一次")
        super().__set__(instance, value)

使用示例 #

class Service:
    @OnceWriteProperty
    def endpoint(self):
        return self._endpoint

    @endpoint.setter
    def endpoint(self, val: str):
        # 还可以在这里保留原有赋值前的校验逻辑
        if not isinstance(val, str) or not val.startswith(("http://", "https://")):
            raise ValueError("endpoint 必须是合法的HTTP/HTTPS链接")
        self._endpoint = val

# 测试
s = Service()
s.endpoint = "https://api.example.com"  # 第一次赋值正常执行
s.endpoint = "https://api.test.com"     # 第二次赋值触发 AttributeError

其他可行的实现思路 #

• __setattr__统一拦截方案：适合需要对类内多个可写一次属性做批量管控的场景，无需为每个属性单独加装饰器

  class Service:
      # 声明所有仅允许赋值一次的属性
      _once_write_attrs = {"endpoint", "timeout"}
  
      def __setattr__(self, name, value):
          if name in self._once_write_attrs and name in self.__dict__:
              raise AttributeError(f"属性 '{name}' 仅允许被赋值一次")
          super().__setattr__(name, value)
  

• setter装饰器方案：适合单个属性的轻量改造，不需要额外自定义描述符类

  def allow_set_once(func):
      def wrapper(instance, value):
          flag_name = f"_{func.__name__}_is_set"
          if hasattr(instance, flag_name):
              raise AttributeError(f"属性 '{func.__name__}' 仅允许被赋值一次")
          setattr(instance, flag_name, True)
          return func(instance, value)
      return wrapper
  
  # 使用示例
  class Service:
      @property
      def endpoint(self):
          return self._endpoint
      
      @endpoint.setter
      @allow_set_once
      def endpoint(self, val):
          self._endpoint = val
  

• 独立描述符类方案：和继承property的逻辑类似，适合需要扩展更多自定义属性控制逻辑的场景，需要手动实现__get__/__set__/__delete__方法。

方案选择建议 #

• 仅需要对单个类的1-2个属性做控制：选setter装饰器方案，改动最小
• 需要在多个类中复用该特性：选继承property的方案，最符合Python开发惯例
• 类内有大量属性需要统一做单次赋值管控：选__setattr__拦截方案，代码最简洁

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