VSCode Python扩展问题：同方法内带类型提示的属性无法触发自动补全

问题情况 #

在类的某个方法里创建属性并添加类型提示后，在该方法内访问这个属性时，IDE的自动补全只显示Python通用对象的内容；但换到其他方法里访问同一个属性，自动补全能正常显示类的专属方法和属性。

解决办法 #

1. 类顶部提前声明属性类型 #

直接在类的开头就明确属性的类型，让IDE从一开始就能识别这个属性的具体类型：

class MyService:
    db_client: DatabaseClient  # 提前声明属性类型

    def __init__(self):
        self.db_client = DatabaseClient(host="localhost")
        self.db_client.  # 这里自动补全可正常触发

2. 方法内用类型断言明确类型 #

如果不想在类级别提前声明，可以在方法内给属性做类型断言，直接告诉IDE它的具体类型：

class MyService:
    def __init__(self):
        self.db_client = DatabaseClient(host="localhost")
        # 给变量指定类型后使用
        typed_client = self.db_client  # type: DatabaseClient
        typed_client.query()  # 自动补全正常显示query方法
        # 或者直接在访问时加断言
        (self.db_client  # type: DatabaseClient
        ).connect()

3. 用typing.cast强制类型转换 #

借助typing模块的cast函数，明确属性的类型，辅助IDE完成类型识别：

from typing import cast

class MyService:
    def __init__(self):
        self.db_client = DatabaseClient(host="localhost")
        cast(DatabaseClient, self.db_client).connect()  # 自动补全正常工作

问题原因 #

IDE做静态类型分析时，在方法内执行到属性赋值的代码前，无法提前知晓self.xxx的具体类型。就算后续完成赋值并添加了类型提示，当前方法内的上下文分析可能无法及时更新这个类型信息。但在其他方法中，IDE会从整个类的属性定义（包括各个方法内的赋值）综合推断类型，因此能正常触发专属内容的自动补全。

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