11、高效采用类型检查的实用指南

高效采用类型检查的实用指南

1. 价值与成本曲线

在软件开发中，类型注解的价值（Value）可以通过公式 Value = (Total Benefits) − (Total Costs) 来衡量。这里的收益和成本并非线性函数，而是会随时间呈现特定曲线。成本曲线一开始较高，但随着类型注解的采用增加，成本会逐渐降低；收益曲线则相反，起初收益较低，但随着对代码库的注解增多，收益会不断提升。只有当这两条曲线相交时，才会实现投资回报。为了最大化价值，我们需要尽早达到这个交点。

2. 提前实现收支平衡的策略

2.1 找出痛点

减少当前面临的痛点是产生价值的最佳方式之一。可以从以下几个方面入手：
- 分析错误案例 ：查看测试失败和客户反馈的错误，对这些错误进行根本原因分析。常见需要关注的错误类型包括：
- 与 None 相关的任何错误。
- 无效的属性访问，例如在错误的类型上访问变量或函数。
- 类型转换相关的错误，如整数与字符串、字节与字符串、列表与元组之间的转换错误。
- 与相关人员沟通 ：
- 与在代码库中工作的开发人员交流，找出那些经常造成困惑的区域。因为如果当前开发人员在某些部分有困难，未来的开发人员可能也会遇到同样的问题。
- 与技术支持、产品管理和质量保证等虽不直接参与代码编写但对代码库有投资的人员交流。他们往往对代码库中痛苦区域有独特的视角，这些痛点可能在查看代码时并不明显。尽量将这些成本用具体的时间或金钱来衡量，这对评估类型注解的益处非常有价值。