学习目的:
1,为什么要注释
2,怎么做注释
为什么要注释
刚开始入行的时候,觉得代码自己看得懂就可以。写注释干嘛?浪费时间。后面又一次我的代码被大佬review,一顿恶骂后,我还是没有觉得这个重要性。直到有一天我背安排对一个功能进行二次开发的时候,我记得我从早上打开电脑能够嘴巴开始碎碎念到下班的时候,才明白:注释真的很重要。
1,方便自己排查问题
2,方便后面的同事填坑
3,为了人身安全
4,为了涨薪
怎么做注释
开头:
/**************************************************************************************************
* Name: CPQ_DiscountVocherCtl
* Object:
* Purpose: Controller for Aura CPQ_DiscountVoucher
* Author: Christ Lai(xiong.lai@xxxx.com)
* Create Date: 2019-08-07
* Modify History:
* 2019-08-07 xiong lai Create this class
**************************************************************************************************/
中间:
1,内部类的变量要给字段后面写上中文备注,这个字段啥意思(大部分命名很难做到见名知意)