Python中Dataframe.to_dict("records")的返回值该注解为list还是dict？

• 当调用df.to_dict("records")时，实际返回的是列表（list），每个元素对应DataFrame一行数据的字典，这是运行时的真实结果。
• 官方标注返回类型为dict，是因为to_dict()方法的默认参数是orient='dict'，早期Pandas的类型注解没有为不同orient参数做细分，默认标注了最常见的返回类型。
• 类型注解的选择建议：
  • 如果你明确使用orient="records"，从代码可读性和静态检查的角度，应该把返回值注解为list[dict]（Python 3.9+支持，旧版本可用List[Dict]），这能准确反映变量的实际类型，避免后续代码出现类型误解。
  • 虽然类型注解不影响运行时，但它是静态检查工具（如mypy）和编辑器代码提示的核心依据，精准的注解能大幅提升代码维护性。
• 小技巧：如果用静态类型检查工具，可通过类型断言明确类型：

  records = df.to_dict("records")  # type: list[dict]
  

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