如何让你的代码整洁漂亮?

Robert Martin的这句话非常合适:

唯一能有效测量代码质量的方式是每分钟说多少个What-the-Fk

让我深入解释一下:

做代码回顾的时候,我的脑海会涌现出三种不同的情绪:

  • What-the-Fk (厌恶)— 这代码并不需要
  • What-the-Fk (欣赏) —  小伙子很机智
  • What-the-Fk (无奈) — 不知道在说什么

所以当我们看代码的时候,是什么最先影响我们呢?

是代码的整洁漂亮。
同时书写整洁漂亮的代码是一名伟大的软件匠人的标志。

这里有两个涉及到学习这门卓越技术的要点- 知识与练习。知识可以教会职业中所需的模式、原则、实践和启发式。但是只有通过不断的练习和努力工作,这些知识需要被才能成为你的一部分。

所以简而言之,学习书写整洁的代码是艰难的。你必会为此付出汗水。你必将会在实践、跌跌撞撞、失败和熟练中一遍一遍循环直到掌握。这里没有简单的方法或窍门。

这里有一些你可以掌握的编写整洁美丽代码的方法。

名称说明什么

Kendrick Lamar很好的解释道:

如果我要讲一个真实的故事,我会从我的命名开始

在软件中名称到处都是。我们命名函数、类、参数、包以及其他。我们命名源文件和目录以及里面的一切。我们不断的命名,从而使其成为整洁代码引擎中最重要的部分。

你的命名应该望文知义。选择好的名称会花时间,但是当其更艰难复杂的时候却可以节省更多时间。所以注意你的命名,如若有合适的名字就替换掉。每个阅读你代码的人都会因此而很感谢你。

牢记变量、函数或者类的名称应该要回答这三个大问题:存在的理由?做了什么?和如何使用?

这不仅需要好的描述技巧,同时也需要跨越边界的共同文化背景,没有人能比你自己更好地教导你

函数应该只做一件事

Louis Sullivan曾漂亮地说道:

功能决定设计

每个系统都是由程序员设计,从一个特定领域的语言搭建起来的。函数是语言的动词,而类是名词。在任何编程语言中,函数通常是系统中的第一行,编写好的函数是写好代码的实质所在。

这里有两条书写整洁函数的黄金定律:

  • 代码应该少
  • 函数应该专注做一件事,并且做精

所以这也意味着你的函数不应该太大来嵌套其他结构。同时,函数的缩进,不应该大于一个或者两个。该技巧可以使得代码更容易阅读理解消化。除此之外,我们也要使得函数内的语句处于同一个抽象程度。

在同一个函数中混合不同层次的抽象,会使得其令人迷惑,并且不利于管理。主程思考函数就像在讲故事一样,而非如何去写代码。

主程用其所选的编程语言的架构来构建一个更丰富,更有表现和更干净的代码块,就像一个完美的讲故事的人

注释并不能弥补劣质的代码

Venus Williams曾很好地说道:

每个人有自己的注释,这就是谣言开始的方式

注释就像两面刀。没有什么比得上放置妥当的注解。另一方面,没有比无聊无用的注解更浪费空间的。同时没有比传递错误信息的注解更具有破坏力的。

简而言之,注释至多是个必要的恶魔。为什么这么说?虽然不是一直但是大部分时候,注释越老,维护起来越困难,大部分程序员都因为不维护注释而臭名昭著。

代码移动和更改:代码块移动到其他地方,而注释不随着移动,就会成为一个问题!

要牢记,带有一点注释并且整洁和有表现力的代码,要远远好过复杂并带有大量注释的代码。不要浪费时间去解释你写的代码,而去投入时间去使其整洁。

优先进行代码规范化

Robert C. Martin有句话很正确:

代码规范化是要去交流,而交流是一个专业的开发者首先要做的。

上面这种说法是不能低估的,也是一名正真的伟大的开发者的最重要特征之一。

规范化的代码就像大脑的窗户。想要通过清晰的条理,细节的关注和明晰的想法来让人留下深刻印象。再看看代码,如果他们看到乱七八糟的代码,没有清晰的开头和结束,那么毫无疑问会会玷污我们的荣誉。

如果你觉得让代码工作是专业开发者的头等事情,那你离真相将更远。你现在创建的功能很有可能在下个版本中被替换,但你的代码可读性将不会改变。

在原始代码完全变得不能识别之后,代码的风格和可读性会持续的影响代码的维护。

要知道将来被记得的是你的代码风格,而几乎不是你的代码。所以你需要注意你的规范化并约束在整个小组的能理解简单的规范下。

书写你的try-catch-finally语句

Georges Canguilhem曾说:

犯错是人类的本性,但是持续犯错就是穷凶极恶的

解决错误是所有程序员都会做的。输入可能不正常,设备可能工作不正常。作为开发者,我们致力于让 代码的如期运行。然而,问题不在于解决错误,而是用干净可读的方式解决错误。

很多代码是由错误处理组成的。代码就变得如此分散,以至于完全磨灭了主代码的目的和逻辑。这是错误,彻底错误的。代码应该是整洁的、健壮的,可以用优雅的方式风格解决错误。这是一名伟大软件匠人的标志。

一个处理的方法是在try-catch语句中合理的闭合并捕获错误。这些块某种程度上也定义了你代码的作用域。当你在try-catch-finally语句中的 try部分执行代码的时候,就是在表明执行会在任意时刻终止,并在catch中恢复。

因为这个原因,写代码的时候从 try-catch-finally语句写起是个好的实践。这可以帮助你确定可以预期到的用户代码,不管代码在 try有没有报错。

牢记你的每次例外都应该包含足够的上下文来确定错误的来源和位置。在代码完成或者程序员离开组织后,创意性的错误信息会被长期记得

把它们放在一起

所以在这里总结一切的单词是什么?

答案是代码意识,在软件中相当于常识。

根据Robert Martin说的:“书写清洁的代码,就需要在疼苦的“清洁”感中,严谨的使用无数小技巧”。而这些小技巧统称代码意识。"

一些人生来有之,其他人就需要通过疼苦的坚持锻炼来获得。代码意识不仅可以帮助我们区分优秀的代码与劣质的代码,而且可以有助形成策略将劣质代码转换为优质的代码。

它用鲜明的词句表明了:仅仅是烘烤一个可爱的蛋糕是没有帮助的,如果你已经用狗屎给其上霜了。

这代码意识可以帮助程序员选择最好的工具,去指导他或者她努力创建一个更有价值的整洁漂亮的代码。

简而言之,一个有代码意识的程序员就如同一名画家一样,可以把空的画布变幻成一幅优美传世的杰出作品。

最后

正如Harold Abelson总结道:

程序员必须为了让人能阅读代码而书写代码,而机器执行只是顺便的。

阅读原文

看完文章,还有福利拿哦,往下看👇👇👇
感兴趣的小伙伴可以在公号【grain先森】后台回复【190315】获取【Css 参考规范】,可以转发朋友圈和你的朋友分享哦。

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

推荐阅读更多精彩内容

  • 一、整洁代码 A.混乱的代价 1.有些团队在项目初期进展迅速,但有那么一两年的时间却慢去蜗行。对代码的每次修改都影...
    ZyBlog阅读 2,027评论 0 2
  • 0. 写在前面 当你开始工作时,你不是在给你自己写代码,而是为后来人写代码。 —— Nichloas C. Zak...
    康斌阅读 5,311评论 1 42
  • 代码整洁之道 Clean Code 第一章 整洁代码 代码的重要性我们永远抛不掉代码,因为代码呈现了需求的细节。在...
    Pengzh1阅读 1,211评论 0 1
  • 这几天终于读完了《平凡的世界》,很久都没有读到这种会让我心心念念牵挂着当中人物生活的小说,也很久没有读完一部...
    老糯米阅读 2,615评论 0 1
  • 清明的雨 是我想你的泪 纤细而清零 容不得放置和接捧 若你要轻声细问 落地的无声 是我难言的话语 枝叶的露水 是我...
    Yinfa阅读 181评论 0 0