程序员的编码规范随想

由系统里残留的函数,引发起了一场编码规范的讨论。

群枪舌战,争锋相对,只为更优质的代码。老大和同事们的认真与热忱,深深地感动了我。从这群平均年龄30+的同事身上,我看到对他们而言,写代码是件很开心的事,而不只是一份养家糊口的工作。

之前还会有很多的担心,害怕自己能力太弱,害怕技术更新太快。不过,这又怎么样呢?不会的东西,去学就是了。像老大掌握一个东西,花2天就行,我花1个月可能还掌握不了。那就用1个月好了。慢慢跟上,不断缩小速度就好啦。

起初使用Reload(),后来逐步替换为HotReload()。旧的依旧存在,只是无人问津。
问题:既然目的是替换之前,为啥不直接改名?
简单完美的方法不用,而留着这样的包袱。没有意外就是要背一辈子的了。

关于编码规范,老大极力推荐《程序员修炼之道:从小工到专家》、《编程珠玑》、《代码大全》

讨论内容,主要如下:

关于命名:

 

绝大多数情况下, flag handler 等类似的命名是完全没意义的,约等于 tmp。
这个命名最大的问题是不够精准。名字表现的范围大于要形容的实际大小。

何同学举得这个例子特别形象。

如果是一条狗,就不应该起个名字叫animal。
如果明确是京巴,那dog也是不合适的。

关于重复:

DRY - Don't Repeat Yourself

Simple is perfect.
复杂问题简单化,没有问题绝对不要创造问题解决。
没有完美地程序,总要学习把握在什么时候止步。
多一行代码,多一行风险。即使只是打印一行代码。
越是复杂,越容易隐藏问题。
已有的轮子,就尽可能的复用,而不是新建轮子。

好的代码是实现功能,保证一定扩展性的情况下减无可减,而不是加无可加。

有很多道理,大家都是知道。但是只有在实际检视代码的时候,才能更深感受到不好的编码习惯带来的坑,还有好的规范带来的好处。

关于巧合编程:

做好的了功能,不知道怎么做好的
出了bug,不知道怎么错误的

很像水螅,你戳它一下,他全身都动。因为它的神经系统没办法定位痛点。

关于重构:

重构遇到的错误,让我们现在成了实实在在的保守派。已上线的内容,即使看起来再别扭难受,只要它还能正常完成工作,就保持不动。

我在杀猪的时候遇到了一些麻烦,因为我对猪的生理结构不清楚,或是这本来就是一头畸形的猪,导致我杀的猪很难看。而换一把更快更漂亮的刀,也不能改变内部问题。

所谓字如其人,程序员的代码也是如此。写过的每一行代码,都是程序员的脸面。


陈皓说,相对于编程风格糟糕,编程能力高超的程序,他更愿意招一个编程水平一般,但是编程风格良好的程序。做一个编程水平高端的人,是需要长期不懈努力的,但是给自己做脸,还是能很快看到效果的。

阅读更多代码,刻意养成良好的编程习惯。

posted @ 2018-08-08 14:16  faithfu  阅读(469)  评论(0编辑  收藏  举报