如何消除PyCharm中‘实例属性在__init__外定义’的警告

无需编写冗余代码，以下几种方案既能实现你想要的“统一初始化/重置”的C++风格逻辑，又能消除PyCharm的警告：

方案1：__init__中先声明属性占位，再调用重置函数 #

在__init__里先给所有需要的属性赋临时值（比如None），让PyCharm识别到这些属性属于实例，之后调用统一的重置函数设置默认值：

class Motor:
    def __init__(self):
        # 提前声明所有实例属性，消除PyCharm警告
        self.speed = None
        self.torque = None
        self.temperature = None
        # ... 其余27个变量
        self.reset_all_values()
    
    def reset_all_values(self):
        # 统一设置所有属性的默认值
        self.speed = 0
        self.torque = 0.0
        self.temperature = 25.0
        # ... 其余27个变量的默认值

方案2：用类属性存储默认值，批量赋值 #

把所有属性的默认值定义为类属性，在重置函数中批量给实例属性赋值，既集中管理默认值，又减少重复代码：

class Motor:
    # 集中定义所有属性的默认值
    DEFAULT_SPEED = 0
    DEFAULT_TORQUE = 0.0
    DEFAULT_TEMPERATURE = 25.0
    # ... 其余27个默认值
    
    def __init__(self):
        self.reset_all_values()
    
    def reset_all_values(self):
        # 逐个赋值（变量少的时候用）
        self.speed = self.DEFAULT_SPEED
        self.torque = self.DEFAULT_TORQUE
        self.temperature = self.DEFAULT_TEMPERATURE
        # ... 其余27个变量
        
        # 变量较多时改用循环批量赋值，进一步简化代码
        # for attr_name, default_val in self.__class__.__dict__.items():
        #     if attr_name.startswith("DEFAULT_"):
        #         instance_attr = attr_name[8:]
        #         setattr(self, instance_attr, default_val)

方案3：使用类型提示声明实例属性 #

Python 3.6+支持在类级别直接声明实例属性的类型，PyCharm会识别这些属性属于实例，即使在__init__外赋值也不会触发警告：

class Motor:
    # 类级别声明属性类型，告知PyCharm这些是实例属性
    speed: int
    torque: float
    temperature: float
    # ... 其余27个属性的类型声明
    
    def __init__(self):
        self.reset_all_values()
    
    def reset_all_values(self):
        # 统一初始化所有属性
        self.speed = 0
        self.torque = 0.0
        self.temperature = 25.0
        # ... 其余27个变量的默认值

总结 #

三种方案各有侧重：

• 方案1最贴合C/C++开发者“先声明变量”的习惯；
• 方案2便于默认值的集中管理和修改；
• 方案3最简洁，符合现代Python的类型提示规范。

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