Python函数参数类型标注应使用pandas.DataFrame还是完整类路径？

明确结论：TYPE位置应当填写pandas.DataFrame，不推荐使用完整内部路径pandas.core.frame.DataFrame，理由如下：

• pandas.DataFrame是官方公开的稳定API别名。pandas在顶层包的初始化文件中已经将DataFrame从内部实现模块导出到了pandas根命名空间下，这是官方文档、开源项目中通用的标准写法，开发者的认知成本低，代码可读性更强。
• 内部实现路径不具备跨版本兼容性。pandas的内部模块结构可能随版本迭代调整，一旦DataFrame的存储路径发生变化，pandas.core.frame.DataFrame的写法就会直接失效，但顶层别名pandas.DataFrame官方会长期保持向后兼容，不会出现版本适配问题。
• 类型检查工具对公开别名的支持完全达标。不管是mypy、pyright等静态类型检查工具，还是PyCharm、VS Code等IDE的类型提示功能，都可以正确识别pandas.DataFrame的类型定义，和写完整内部路径的校验效果完全一致，不会出现类型匹配错误。
• 符合Python生态的类型标注通用惯例。所有第三方库的类型标注都推荐使用库对外公开的导出别名，不需要追溯类的内部实现路径，这是整个Python行业通用的书写规范。

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