你见过的“垃圾”项目是这样子么?

我是一个着迷于产品和运营的技术人,乐于跨界的终身学习者。欢迎关注我的个人公众号「跨界架构师」

每周五11:45 按时送达~

我的第「183」篇原创敬上


大家好,我是Z哥。

我相信每一位程序员最怕遇到代码质量堪忧的项目,毕竟增加一个同样的功能,在一个代码整洁、清晰的项目里与在一个代码混乱不堪的项目里,效率和质量上的差距达到一个数量级一点也不奇怪。

但是残酷的现实是,“垃圾项目”到处存在,哪怕是大厂里也不例外。毕竟,没有人天生就能写出无比优雅的代码,都是通过写“垃圾代码”一步一步成长起来的,唯一的区别可能就是成长的速度不同罢了。

一个项目如果运气好,未来成为受重视的项目,那么它还有机会摆脱不少的“垃圾代码”,但是如果没那么好运,那就苦了后来人了。

所以,如果你是一位新人程序员,那么我得提醒你,一定要有一个合理的预期,这个合理的预期就是——与垃圾代码长期为伴。因此,如果你以后因为遇到“垃圾代码”而破口大骂,这是不讲“码德”的。什么?那么索性跳槽?你怎么能确保下一个接手的项目会更好?


在Z哥看来,一个项目走向“垃圾”、人见人弃的地步,原因只有一个,代码垃圾,而什么样的代码才算垃圾代码?这就多了,我与你分享一些常见的。


01 组件颗粒度过大

现在三层架构基本已经成为一个基础共识了,只要不是太古老的项目,不太会存在UI、业务逻辑、数据操作写在一起的情况。(虽然架构设计方面的后起之秀很多,但是三层架构因为更容易理解,所以市场占有率依旧最高)

但是三层架构的每一层又该如何进一步细分,如何建模?还没有能够成为共识的统一标准或者最佳实践出来。

所以,很多项目在经历了一年以上的业务发展和变更后,业务逻辑层往往率先沦陷,开始出现大对象,成为开发效率的瓶颈。


近几年的火热的领域驱动设计其实已经开始深入到每一层的内部该如何划分上了。但是离达到共识还有很长的路要走。


02 API数量泛滥

有一些经验的程序员们会用一招来让自己在垃圾代码中游走自如。这招就是尽量通过“增加”的方式实现功能而不是“修改”历史代码。

这种方式的确能避开很多“屎坑”,但是从长期来看,这大概率是在创造新的“屎坑”。

某些核心class里几百个function,成千上万行的代码就是这么来的。


03 低内聚、高耦合

「高内聚、低耦合」是软件开发领域的一条黄金法则,相信每一位程序员都知道。但是现实是,很多项目都存在低内聚、高耦合的问题。

出现这个问题倒也不是说是由于大量的重复代码导致,而是过度的追求消除重复代码。盲目的追求减少重复代码,自然会导致代码被过度拆分,原本一个完整的业务处理清清楚楚,硬生生被拆分到多个function里去。

复用当然是好的,但应该有个前提条件:不增加系统复杂度的情况下的复用。如果不这样做,损害了稳定性,增加了复杂性,还会造成代码可读性降低。


04 业务逻辑和程序处理逻辑纠缠

Z哥认为,代码的作用其实就分为两种,业务逻辑和程序处理逻辑。前者体现的是这个软件的现实价值,后者则是让软件能在计算机上run起来必不可少的部分。

程序处理逻辑主要就是各种数据的存取、dao操作、序列化/反序列化、缓存操作,以及异常处理、参数和返回值准备等等。

如果程序的处理逻辑与业务逻辑混在一起,就好比芝士拌饭,都黏在一起,随便改一小点功能就扯出一大段代码要看。

更加可怕的是,如果里面还充斥着大量Magic Number,比如if (errCode == 50001) 。那你得忍住不要骂人。


05 又长又宽的if else

这点其实长期以来就是一直被人诟病的陋习。但是这又几乎是每一门编程语言都有的语法,那么问题到底在哪里?

因为不管是if else也好,还是switch case也好,其实是一种硬编码的方式。这就会导致它不容易被修改。

想象一个场景:某个枚举增加了一个新的值,这个时候你需要将原先判断这个枚举的所有if else都检查一遍,以确保新增的业务能正确执行。真正做过这件事的人相信有过深刻地感受,如果这个枚举被用到几十上百的地方,检查一遍外加弄懂上下文,估计至少半天时间就没了,而且很有可能最终还是漏改或者改错什么。


以上就是一些常见的垃圾代码的样子。那么,在你的工作中如果遇到充满垃圾代码的垃圾项目该怎么办呢?从流派上说,主要有三大流派,激进派、保守派、重头再来派。


保守派的做法,主要是从局部修改问题代码入手。比如前面提到的这些“垃圾”代码,常见的处理思路是以下这些。

01 业务层禁止层内依赖

你可以留意观察一下,业务层内的内部相互依赖,是导致代码高耦合低内聚的主要推手。因为这会导致一个业务方法体内部经常容易囊括一些不在当前业务逻辑内的分支逻辑,使得每个方法的耦合逐渐提高。

所以,禁止层内依赖对降低耦合有立竿见影的效果,这也是领域驱动设计提倡专门拉出一个Application Layer来协调各个Domain之间的交互的目的。


02 将大函数拆小

让代码恢复健康,最难啃的骨头就是那些动辄几百上千行的函数。保守派虽然避免了大量应用新框架进行替换所带来的工作量。但是这个最难啃的骨头是避不开的坎,否则所谓的代码重构只是隔靴搔痒而已,并没有多大效果。


03 减少代码

减少代码最高效的方式是调用新的系统api或者使用新的框架或者工具。他们可以大批量的代替原先冗余的「程序处理逻辑」。只是对保守派来说,他们会更谨慎地使用新的框架。毕竟,运用一个新框架可是一个不小的手术。


激进派与保守派最大的区别在于,他们更倾向于使用新的框架、工具甚至是新的技术栈、编程语言来解决问题。不过在我看来,这些新东西,可能在短期的确能解决眼前的问题,但是这些问题到底是新技术解决的?还是因为使用新技术而大量重写“新鲜”的代码解决的?值得打上一个问号。


最后的重头再来派很有意思。他们认为老项目已经没救了,必须重做才行,这是比激进派更激进的一个流派。

可是我见过好多重头再来派的人员,重头再来做出的项目,在其他人眼里可能并没有比之前好多少,甚至在过了一段时间之后,发现重新陷入了之前的困境之中。

因为盲目乐观是我们人性的弱点。这就像创业者总觉得自己是九死一生中唯一生的那个,买彩票的人总觉得自己是那个千万分之一的幸运儿一样。


这三个流派,并没有绝对的好坏之分,不同的流派都有不同的适用场景,区别就在于「时间、成本、质量」这三个要素上的取舍不同。所以,我们在选择方案的时候可以根据这三个要素的具体情况来判断。

因为Z哥认为一个项目的核心要素就是这三者,并且这三者无法兼得,最多只能取其二,类似于分布式系统领域的CAP定理。

Z哥有幸分别参与和主导过这三个流派的工作,以我的经验来看,我认为这三个流派分别适用的项目情况如下:

    ■ 保守派。时间快,成本低,对质量仅有最基本的要求。

    ■ 激进派。有较高的质量要求,满足时间较宽裕或者接受成本大幅增加其中的一点。

    ■ 推倒重来派。时间和成本完全给质量让步,追求可见范围内的最好。

其实这么一分析你也能发现,总是推倒重来是不现实的,时间和成本这种属于资源,资源总是有限的。所以,大多数情况下,保守派的选择才是最常见的。因此我们更应该思考的是如何通过保守改造最大化提高项目的质量,让他摆脱“垃圾”的标签。这需要我们沉下心来才能完成,不要老想着推翻重做。


好了,总结一下。

这篇呢,Z哥和你分享了我对如何应对“垃圾项目”的看法。

首先和你分析了5个常见的使得项目逐渐变得垃圾的陋习。

    1.组件颗粒度过大

    2.API数量泛滥

    3.低内聚高耦合

    4.业务逻辑和程序处理逻辑纠缠

    5.又长又宽的if else

然后分享了三个常见的保守派做法:

    1.业务层禁止层内依赖

    2.将大函数拆小

    3.减少代码

最后分享了应对“垃圾项目”时的三大流派,分别是:

    1.保守派

    2.激进派

    3.推倒重来派

从时间、成本、质量三个维度的权衡来看。保守派才是主流,所以不要动不动就想着推倒重来,收起浮躁的心,沉下心来。

好了,希望对你有所启发。


推荐阅读:

    ■ 想得很好,做起来总是不行?

    ■ 帮助阅读源码的8个技巧


如果你喜欢这篇文章,可以点一下右下角的「爱心」,支持我的创作~

定期发表原创内容:架构设计丨分布式系统丨产品丨运营丨一些深度思考。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 218,204评论 6 506
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,091评论 3 395
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 164,548评论 0 354
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,657评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,689评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,554评论 1 305
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,302评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,216评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,661评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,851评论 3 336
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,977评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,697评论 5 347
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,306评论 3 330
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,898评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,019评论 1 270
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,138评论 3 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,927评论 2 355

推荐阅读更多精彩内容