闲谈团队的代码质量

定义代码质量

首先当你开始意识到项目里代码质量差的时候,恭喜你已经有了代码审美。这是推进编程水平的重要的一步。很显然,如果你不知道什么是差的代码,你就写不出好的代码。写不出好的代码,更高的架构也就无从谈起。

先来定义团队代码质量的黄金标准:易维护。

代码最基本的要求,易读。现代的软件项目都不是一朝一夕,有团队合作,有新需求,要修bug,代码不只是只给机器读的,是给人读的。一份清晰、易懂的代码就包括了:良好的代码风格,清晰的逻辑,合理的结构。也许做到90分和天赋有关,做到70分其实没难度,单纯看你花了多少努力在这件事。

很多人用中文写几百个字描述一件事都说不清,一个逻辑有两千行代码又怎么可能写的清楚呢。锻炼过程也和提高表达能力相似,只是之前是某种文字,现在是用代码。文学里有修辞手法,有总分总,代码里有语法糖,有MVC。

代码质量从何开始

如果重视代码质量,如何达成代码质量的基本共识呢?

解决这个问题的核心并不是一本万能手册。不存在一本黄金宝典,包含了各式各样的代码,任何时候都可以按图索骥得到一个检验标准。你能得到的是一个评判的方式,可以从哪些角度去认知代码,最后发现这样的代码在这个条件会引起一些问题,所以这代码不够好。

我认为的起点是这几本书:《编写可读代码的艺术》《代码整洁之道》《重构》《代码大全》。就如前面说过的,这些书的重点并不是具体某个代码、某种条件下好的代码长什么样,而是他们怎么得出了这样的结果。当你理解了这几本书的核心思想后可以开始正确审视自己的代码质量了,可以开始code review了。

追求代码质量是一个成长的过程

代码质量就像作者写出好的文章一样,是一个不断进步、不断推进的过程。

一开始你可能写十几行就要停下来思考,这个命名合不合适,这样的逻辑是不是有点乱。后面可能到一个类的封装是不是合适。再后面可能几个月回头看自己的代码才意识到,当时这样写会有歧义,扩展性不好等等。

这也是自己不断提高编程能力的过程,写出易维护的代码只是第一步。

没有code review的团队没有未来

如何提高团队的代码质量?

代码是有程序员写出来的,如果每个人都是老江湖,团队的代码质量就高了啊。可是能有几个团队每个人都能写出高质量的代码?

其实真的非常简单,严格的执行code review就可以了。让那些知道好代码长什么样的人控制代码质量。就像工厂里的质检,不合格的代码不会被合进代码库。

没有code review的团队没有未来。

要不就是这个团队技术能力差,没有能力进行review。

要不就是项目简单,不需要review,什么垃圾代码都可以完美支撑。

要不就是项目复杂,团队技术实力也可以。核心代码由救火队员控制,他们根本不关心其他人代码写成怎么样。出问题了他们救火,他们会保证项目运行,其他成员技术能力的提高不在意。

最后一种情况可能是最常见的情况,但是也是最可悲的情况。他意味技术团队的负责人本质上并不关心成员的技术成长。提高项目代码质量的最终实现还是靠每个成员的能力可以写出高质量的代码。每个人都成长了,最后项目代码质量自然就提高了。然而管理技术团队的人没有意识去促成这件事情的发生,那么一个新手在这样的团队成长还是靠自我摸索,这会是一个缓慢的过程。

Code review就像快进的结对编程,一个老手点评一个新手代码的时候,就会产生交流,要阐明为什么不能这样写。在保证项目质量的同时,对新手也进行了指引。两个水平相当的人review则得到了其他视角的审视结果,最后交流的结果就是两个人都得到了更全面的见解。

所以没有code review的团队没有未来。每个团队都有自己的基因,如果你在团队没有话语权,只能祝你早日找到一个有review的团队,不要期望通过自己的努力改变他们。以我的经验来看,无法叫醒一个装睡的人,一个真正好的团队,推进code review不会有任何阻力,如果有,开掉那个人。

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

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 170,566评论 25 707
  • error code(错误代码)=0是操作成功完成。error code(错误代码)=1是功能错误。error c...
    Heikki_阅读 3,102评论 1 9
  • 2017年9月15日,我同学发生了一个事故,脑部受到重伤,暂时性失忆了,需要大量的医药费,希望大家伸出援助之手,献...
    ANNIE_e556阅读 131评论 0 0
  • 床前明月光,疑是地上霜。
    二月十八日事件阅读 232评论 0 0
  • 梁艳丽私藏着大红的结婚证,如同违禁的某个走私品一样,不敢示人。她小心的跟妈妈试探说,黄挺坚真是个臭不要脸的东西,天...
    福星A阅读 151评论 1 0