如何自动校验Python type stub包？openpyxl-stubs常见问题排查方法

• 使用stubtest：这是mypy官方内置的stub校验工具，专门用于比对类型桩与实际库的差异，可直接批量检出你提到的所有问题：包含缺失/冗余的模块、类、方法，参数数量/类型不匹配，返回值注解缺失等，无需手动核对代码。安装mypy和对应版本的openpyxl后，直接执行stubtest openpyxl即可生成完整的问题报告，耗时短效率高。
• 启用pyright严格校验：打开pyright的reportMissingTypeStubs、reportIncompatibleMethodOverride、reportArgumentType等校验规则，找几个依赖openpyxl的热门开源项目跑全量类型检查，出现的类型报错大部分都对应stub的不合理实现，比自己编写测试用例覆盖范围更广。

• 写简易脚本做结构比对：用importlib递归遍历openpyxl所有可导出的子模块、类、函数、属性，再递归读取你的stub文件里的所有声明内容，两边取差集即可直接得到缺失模块、冗余废弃模块、缺失/废弃类方法的完整清单，十几行代码就能完成全量结构核对。

• 使用flake8-pyi插件：这是专门针对.pyi stub文件的lint工具，可自动标记出参数注解缺失、返回值注解缺失、注解类型不合法等常见问题，全量扫描一次就能清掉所有明显的注解格式错误。
• 开启mypy严格stub校验：在mypy配置中打开disallow_untyped_defs、disallow_incomplete_defs规则，扫描你的stub目录，所有未补全的注解都会直接抛出错误提示。

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