Pylance无法识别list[int]类型注解，函数参数正常但变量报错怎么办？

我想使用内置类型注解list[int]替代typing.List[int]，但Pylance无法将list[int]识别为有效的类型表达式。奇怪的是，函数参数的类型注解用list[int]完全没问题，怎么才能让Pylance认可它作为变量的类型注解？

错误提示 #

Pylance错误： #

Variable not allowed in type expression Pylance (reportInvalidTypeForm)

终端运行错误： #

PS C:\Users\user\Programming\Python\pythonED> & "C:/Program Files/Python313/python.exe" "c:/Users/user/Programming/Python/pythonED/exercise14.py"
Traceback (most recent call last):
  File "c:\Users\user\Programming\Python\pythonED\exercise14.py", line 8, in <module>
    list: list[int] =  [1, 3, 5, 3, 5, 6, 8, 4, 23, 7, 8, 5, 7, 5, 7, 9, 9, 5, 4, 7, 5]
          ~~~~^^^^^
TypeError: list indices must be integers or slices, not type

我的代码 #

def loop_list(b_list: list[int]) -> list[int]:
    list = []
    for i in b_list:
        if i not in list:
            list.append(i)
    return list

list: list[int] =  [1, 3, 5, 3, 5, 6, 8, 4, 23, 7, 8, 5, 7, 5, 7, 9, 9, 5, 4, 7, 5]
print(loop_list(list))

问题原因及解决办法 #

问题核心是你将自定义变量命名为list——list是Python内置类型的名称，你在函数内定义了局部变量list = []，又在全局作用域定义list: list[int] = [...]，这会让Python把list[int]里的list当成你自定义的变量，而非内置类型，从而触发报错。

解决只需修改自定义变量名，避免与内置类型冲突：

• 将函数内的list改为result_list，全局变量的list改为my_list
• 修改后的代码：

def loop_list(b_list: list[int]) -> list[int]:
    result_list = []
    for i in b_list:
        if i not in result_list:
            result_list.append(i)
    return result_list

my_list: list[int] =  [1, 3, 5, 3, 5, 6, 8, 4, 23, 7, 8, 5, 7, 5, 7, 9, 9, 5, 4, 7, 5]
print(loop_list(my_list))

修改后，list[int]会被正确识别为内置类型注解，无需依赖typing.List即可正常使用。

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