为何tuple[int]与list[int]类型提示表现不同？如何标注整数元组？

问题根源 #

在Python类型提示体系里，tuple[int]和list[int]的语义存在本质区别：

• tuple[int]特指长度为1的整数元组，所以你传入(1,2,3)这种长度为3的元组时，IDE会判定类型不匹配并抛出警告。
• list[int]则表示任意长度的整数列表，不管列表里包含多少个整数元素都符合类型要求。

正确写法 #

根据你的实际需求，分两种场景处理：

• 如果要表示任意长度的整数元组，使用tuple[int, ...]，这里的...（省略号）代表元组可以包含0个或多个整数元素：

  def func_with_tuple(x: tuple[int, ...]) -> None:
      pass
  
  func_with_tuple((1, 2, 3))  # 不会触发类型警告
  

• 如果是固定长度的元组，直接明确写出每个位置的类型即可，比如长度为2的整数元组就写tuple[int, int]。

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