良好代码风格

作者:王路

我零九年看过一本小说,讲程序员的故事,从此,了解了一个新物种。最近又看《红楼梦》,史湘云有条谜语:“溪壑分离,红尘游戏,真何趣?名利犹虚,后事终难继。”我一想,这不就是程序猿吗?

  我学过半年编程,唯一的收获是记住了一个名字叫谭浩强。读了那本小说,我知道还有个东西叫“良好的代码风格”,这几个字可比谭浩强有意思多了。可以跨领域应用,比方说,用在写作上。

  例如,变量的命名。像本文,如果叫《论良好的代码风格》,姿态就不佳,一个“论”字就让读者反胃了。如果叫《如何写出良好风格的代码》,太装了,好像自己是编程大师似的。换一种叫法,《扯扯良好代码风格的淡》,就好比南锣鼓巷走了一圈,感觉亲民多了。

  不过,本文也没那么叫,因为作者不忍心欺负程序猿。程序猿是很实诚的物种,被题目忽悠进来,发现作者根本不懂编程,就会愤怒得跟猩猩似的。可也不是不讲编程的书就对程序猿无用,《禅与摩托车维修艺术》就很好,适合程序员读。

  闲话休提。说到变量命名,金庸就是个中高手。像四大恶人的外号:恶贯满盈,无恶不作,凶神恶煞,穷凶极恶——同类型变量中包含特定的元素,一看就记住了。再比方,穆念慈和包惜弱,这两人从未谋面,名字却是工稳的对仗,暗指二人是母女关系:穆念慈的“慈”,就是一个指针指向包惜弱,包惜弱的“弱”也是一个指针指向穆念慈。慈就是母,弱就是子嘛。

  《侠客行》开头有个“卖饼老者”,卖饼老者有没有名字呢?有,叫吴道通。那金庸为什么不直接称呼他“吴道通”呢?答曰:占用内存。读者记太多名字会累的,哪怕名字都是丁不三、包不同这种,多了也记不住。一个无名小卒,戏份太少,特地安个名字不划算。名字相当于一个指针,读者看到名字,首先想到这个人的特征和身份,才明确这个人。对于戏份太少的角色来讲,变量不存在多次赋值的问题,安排指针是大大的浪费。

  但金庸还是说出了他的名字,不过金庸并不是直接以叙述的方式告诉读者他叫吴道通,而是通过他的对手骂他:“姓吴的,你想怎样……吴道通,你到底要怎样……”接下来,就把他名字自然替换成吴道通了。为什么又要替换呢?因为紧接着出现了第二个“老者”,若不替换,这老者和那老者就犯了重名的问题。可见,“老者”其实相当于一个局部变量。同样,“胖子”、“店小二”也是。

  《侠客行》第一章是这么写的:

    汴梁城外的一个小镇,暮色时分,四围响起了马蹄声,由远而近,浩浩荡荡,没人知道出了什么事情。——这时,金庸把笔锋宕开,写镇上人的各种惶恐不安,战战兢兢,于是小镇气氛更加凝重紧张。紧接着,马蹄涌入城内,一帮凶神恶煞的人列队排开,当中一人穿着皮靴踏着石板路走来…… 整个暮光下的小镇上,唯一的声音是他的皮靴声。唯独有个卖饼老汉,依旧做烧饼,对一切置若罔闻。此人不忿上前,卖饼老汉顺手把他灭了。可是,一个冷眼旁观的老者周牧又站出来,把卖饼老汉解决了。而周牧见了安金刀,却远不是安金刀对手。这时,石清闵柔出现了,果断把安金刀打趴下了…… 然后,谢烟客闪亮登场,前边的所有人物,一概变成了小喽啰……

  以上,就是一段很好的代码。好在哪里?好在语句间的关系清晰明了,好在各变量和函数定义得一丝不苟。所有的语句之间,层次条理极为鲜明。一个语句是一个语句,一个函数是一个函数。不粘连,不纠结。每段代码要解决什么问题,别人一看就知。不是所有代码混成一锅粥。各小段代码单独拎出来,各各是独立的,各各都好看;但在总体上,又能形成一股合力,指向问题最终的解决。

  文章也该这么写。轮到每个配角的戏份时,要当成主角去写,同时,所有的戏份从整体上看,又要层层递进。文章各段落之间也要形成一股合力,每个小段落既能单独拎出来成立,还要成为整篇文章的一块砖,不能率尔删去。若前者做不到,文章就太粗糙不够细腻,若后者做不到,文章就沦落成了段子集。

  在处理复杂的问题时,往往无法一上手就针对问题本身来提出解决方案,而要先建立起一些基本的模型,再将模型的约束条件渐次放松,得到更为普遍的一般的模型,再将多个这样的模型组合在一起,使之复杂化。

  好的文章也如此,它一定不是单线程的,必然是多线程的。所谓多线程并不是指存在多个主题,它仍然是一个主题和中心,但它蕴藏着多种内涵和意义,所有内涵又必须是统一在大主题之下的。

  像《天龙八部》这部大作品,就极具复杂性。因为过于复杂,整个前15回都是在界定关系,建立模型:段誉上来碰见的无量剑派的斗争,是三十回以后的逍遥派的伏线;鸠摩智到大理取六脉神剑剑谱也直接指向四十回后带头大哥和报信人的问题。北乔峰、南慕容、大理段氏、江南王氏、吐蕃、丐帮,西夏一品堂、逍遥派,除了少林之外,几乎所有重要的函数和模型,都在前15章定义清晰了。

  但变量并没有全数出现。因为有些变量必须到问题复杂到一定程度才能定义。主要人物中,萧峰到了第14回才出场,虚竹到了29回才出场,萧峰出场前已经有了30万字,虚竹出场前已经有了60万字。直到40回后,少林寺大会才将整部小说推向大高潮。少林寺那段之所以是大高潮,是因为在那个模型里,几乎所有的变量、函数、模型都包含进来了,而没有一个是之前未精确定义过的。

  可见,金庸笔下的复杂场面是龙须面,虽细,但一根是一根,根根拎得清。换个人写,就粽成一坨了。

  以上,是良好的代码风格在写作上应用的一些简单探讨。

  但需要说明的是,并非所有的好文章代码风格都好。也有一些大牛作者,代码故意晦涩,却被尊为圭臬。像周作人的散文,陈散原的诗就是。——老子就是不友好,爱咋咋地。别人写代码,尽量把句子拆短,他却三五行代码硬是拧成一行。他要的就是这个效果。他的着眼点不是复杂问题的清晰解决,而是解决思路的别致性。这是另一种风格,本文就不细表了。

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

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,839评论 25 707
  • iOS编程规范0规范 0.1前言 为􏰀高产品代码质量,指导广大软件开发人员编写出简洁、可维护、可靠、可 测试、高效...
    iOS行者阅读 4,446评论 21 35
  • 主要目标:1)一般将来时的定义,结构和常见的时间搭配 2)肯定,否定和一般疑问的变形 ...
    向日葵的小执着阅读 237评论 1 1
  • 一、文本预处理阶段### 1.1 设定训练集和测试集 训练集每一类的数量为500个文档,测试集每一类的数量也为50...
    Shira0905阅读 4,722评论 0 1
  • 今天又重复看了电影爆裂鼓手! 看着男主怎么由一个青涩的音乐学院新生变成了可以随意虐人的大卡,看着他为了打鼓为了提升...
    collinsun阅读 281评论 0 0