站在业务技术团队的开发视角,你认同“可读性”是代码的第一优先级要求吗?
我觉得优先级是可读性。首先,代码这个东西是给人看的,前提是你要能明白表达出来的意思,之后你才能通过你的知识去优化,扩展。
语言表达:普罗大众(普通的能被阅读者一眼看出这语法是用来做什么)+ 良好的代码格式,我觉得这两点放在这里最合适。比如说,判断一个对象是否为NULL,我可以使用if,我也可以使用optional。如果我选择使用optional的话,就会有一个问题,有一部分同学接触过,但是没使用过,他就需要花费一部分时间去了解,这一部分时间如果是放在学习上,那无所谓,反而还有助于锻炼自己自学能力,那如果是在生产急需修改的情况下,这个反而是累赘了。
明确意图:在第一点的基础上 + 合适的变量命名 + 适当的注释。再过简单的事物,经过组合,嵌套等操作,也会变成一个复杂的事物,这个时候就需要提示的帮助了,适当的提示有助于阅读者快速理解。
层次结构:前两点的基础上 + 功能划分 + 写文档,就好比三层架构,mvc架构等经典架构,这些是通用基层架构,再往上就需要我们自己去划分。比如一个完整的后台管理项目,我们可以划分用户管理,部门管理等模块。这些模块虽然在项目中得到了完整的体现,但是这是对于编写项目的人来说,对于第一次接触的人来说,是一个困难的过程,因为他需要从头到尾的熟悉一遍。这个时候,文档的好处就体现出来了,你可以挑选你接手的部分去了解其中的业务逻辑。
赞1
踩0