库维护者经常面临越来越多的 Python 类型检查器(mypy、Pyright 等)所带来的困扰。为了使内部源代码兼容每一个检查器,往往会导致代码臃肿不堪,充斥着大量的 `type-ignore` 注释。 作者认为维护者的优先级搞反了:与其强迫内部逻辑去满足每一个检查器,不如专注于库的公共 API。由于用户依赖不同的类型检查器,最有效的做法是对**测试套件**运行尽可能多的检查器,而不是针对源代码。 对公共 API 进行测试,可以确保无论用户偏好哪种工具,都能获得准确的自动补全、文档说明和错误保护。由于类型检查器在处理公共 API 的行为时往往达成一致,即使它们在内部实现细节上存在分歧,这种方法也能在减少维护负担的同时,显著提升开发者的使用体验。核心结论很明确:在测试中优先考虑跨检查器的兼容性,以确保你的库能为整个 Python 生态系统提供无缝支持。