对伟大前锋来说,进球,以及一个能够迸发出进球能力的身体非常重要。
对靠谱程序员来说,代码质量,以及一颗能够洞悉高质量软件编写之道的大脑弥足珍贵。
本文从产品,接口,指标,日志,代码清晰度,代码复杂度等方面,谈谈如何提高代码质量。
产品和接口
好的产品经理未必是个好的程序员,但好的程序员一定是个好的产品经理。
产品经理的工作是什么?是把复杂的逻辑用清晰的,易用的方式(接口)展现给用户。
程序员的产品是代码,代码的用户是其它程序员——所以高质量的代码是让别的程序员容易理解,容易使用的代码。注意,这个层次的容易理解,是指结构,原理和接口上容易理解,而并非代码的细节容易理解。
细节在产品这个层次,一定要隐藏起来。用户在打开浏览器,访问arcblock.io的时候,并不需要关心DNS是怎么工作的,PKI体系是怎么运作的,HTTP/TLS/TCP/IP协议是什么,报文是怎么从userspace交付到kernelspace,再怎么DMA到网口发送出去——这还没完,接下来出场的,还有负责l2protocol的switch,保护你安全的firewall,邮递员router,以及明明概念上是网络技术,却整个青春都错付给了安全的NAT。。。
如果产品经理做的产品展示给用户是这样巴拉巴拉的细节,那么丫一定会被扯烂暂住证,大耳光从天黑抽到天亮,然后早班绿皮车送到清河去挖沙;如果程序员的main()如此啰嗦,不管人家受得了受不了,那么他这辈子笃定找不到同性朋友,更别说异性了。
所以程序员在写代码之前,先要想想如果这是一篇演讲稿,我该如何说起?我能在三五分钟讲清楚这代码要干什么?有没有生活中或者同行会心一笑立刻get到的例子可以类比?
90%以上的情况,程序员是在写parser。换句话说,我们写的绝大部分代码就是把一系列的输入,经过若干转换(transformation),变成一系列输出。
Copyright © 2005-2018 昕昕网络教程 · 上海链修网络科技有限公司 版权所有 · · 软著登字第1957406号 · 登记号2018SR356128 ·