Python如何声明指定元素类型的list，解决list类型注解运行异常问题

你遇到的报错是两个常见原因导致的：一是Python版本过低不支持原生list泛型标注，二是类型标注存在前向引用，运行时无法识别未定义的类型。以下是对应解决方法：

• 如果你使用Python 3.8及更早版本，需要从typing模块导入泛型List完成标注：

from typing import List

class Item:
    def printDescription(self):
        # 对应方法实现
        pass

class Bag:
    # 用typing.List标注元素类型为Item
    items: List[Item] = []

    def printAllItemsDescription(self):
        # 此处循环的item会被编辑器正确识别为Item类型，可正常弹出printDescription方法提示
        for item in self.items:
            item.printDescription()

• 如果你使用Python 3.9及以上版本，原生支持list[类型]的标注语法，要解决前向引用报错可以二选一：

1. 按照报错提示用引号包裹类型标注，运行时不会解析标注内容，静态类型检查工具仍可正常识别：

class Item:
    def printDescription(self):
        pass

class Bag:
    # 类型标注加引号即可消除运行时报错
    items: "list[Item]" = []

    def printAllItemsDescription(self):
        for item in self.items:
            item.printDescription()

2. 在文件最顶部添加from __future__ import annotations语句，所有类型标注会自动被视为字符串处理，无需手动加引号：

from __future__ import annotations

class Item:
    def printDescription(self):
        pass

class Bag:
    # 直接书写即可，无运行时报错
    items: list[Item] = []

    def printAllItemsDescription(self):
        for item in self.items:
            item.printDescription()

额外说明：Python实例方法的第一个参数约定俗成使用self而非this，遵循该约定可以获得更好的编辑器适配和代码可读性。

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