想额外小小分享个人觉得重要的概念 ‘ 假如写了注解一定要维护 ’
举例
前几年老板委托写尾牙发钱活动程式
中间改了几次关于金钱的逻辑,特别奖金加码,都没有修改过注解
今年老板又要举办一次尾牙抽奖,这次没有加码,另外把程式交给一个新进员工来修改。
```
void Main(){
/*
逻辑:
..略
- 当年资超过一年,奖金+2000
..略
*/
newYearBonusService.SetBonus(emloyee)
}
class NewYearBonusService{
public void SetBonus(Employee emloyee){
..略
if(GetJobTenure(emloyee)>=1) emloyee.Bonus += 8000;
..略
}
}
```
结果新人没有去花时间去读程式,直接相信你的注解,直接上线
抽奖当天才发现钱多给了6000,老板大怒。
类似概念的例子在在现实偶而遇到,因为需求常变更,贪一时之便不去维护注解,
反而一开始就不要注解,把变量、方法命名取好,模组化做好,反而有更有帮助。
另外读别人注解我个人的观念(对版上很多前辈应该是基本概念):
‘ 注解只是补助,程式才是本体
注解会骗你,但程式码不会骗你 ’