如何为初始为None但必被赋值的变量添加类型提示

针对你的场景，有几种靠谱的方案，既能满足类型检查器的要求，又不会触发Pylint的错误：

方案1：使用断言（推荐） #

在use_value方法里添加断言，明确告诉类型检查器self.value不可能是None，同时还能在运行时做一次校验，防止意外情况：

class MyClass:
    def __init__(self):
        self.value: MyOtherClass | None = None
        self.initialize_value()

    def initialize_value(self):
        self.value = MyOtherClass()

    def use_value(self):
        assert self.value is not None, "value 必须在use_value调用前完成初始化"
        return self.value.used

这个方案的好处是：

• 类型检查器会识别断言后的self.value为MyOtherClass实例，不会再报union-attr错误
• self.value在__init__中定义，符合Pylint对实例属性的要求
• 运行时如果出现异常情况（比如initialize_value没被调用），断言会直接抛出错误，便于排查

方案2：使用类型转换（cast） #

如果不想加运行时校验，可以用typing.cast强制告诉类型检查器self.value的实际类型：

from typing import cast

class MyClass:
    def __init__(self):
        self.value: MyOtherClass | None = None
        self.initialize_value()

    def initialize_value(self):
        self.value = MyOtherClass()

    def use_value(self):
        return cast(MyOtherClass, self.value).used

这种方式不会增加运行时开销，但没有运行时校验，适合你能100%保证value已初始化的场景。

方案3：调整属性定义方式（Python 3.10+） #

如果你使用Python 3.10及以上版本，可以在__init__里先定义属性类型为MyOtherClass，暂时赋值None并添加# type: ignore注释，但这种方式不推荐，因为会忽略潜在的类型错误：

class MyClass:
    def __init__(self):
        self.value: MyOtherClass = None  # type: ignore
        self.initialize_value()

    def initialize_value(self):
        self.value = MyOtherClass()

    def use_value(self):
        return self.value.used

综合来看，方案1是最优选择，兼顾了类型检查、代码规范和运行时安全性。

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