首页
学习
活动
专区
工具
TVP
发布
精选内容/技术社群/优惠产品,尽在小程序
立即前往

《Clean Code》读书笔记2

第二章 有意义的命名

· 名副其实

如果名称需要注释来补充,那就不算名副其实。

Felix:在编码过程中,我们还是要尽量使用能够表示真实含意的类名,方法名,变量名。这个是为了让你和他人能够用更少的时间去理解这个类、方法和变量的具体含意。所以,虽然一个名字不会引起程序的崩溃,但是却要让我们付出更多的时间去维护程序。时间就是成本,对于一个公司来说,没有什么比减少成本更重要了吧。

· 避免误导

Felix:由于人类的惯性思维,所以我们在命名的时候,一定要寻找一个和现有名称区分度很大的名称。这样能够更好地防止人为的粗心造成的失误。

· 做有意义的区分

Felix:在平时的编码中,我们经常喜欢使用info,data之类的名词作为后缀,其实从意义上来讲,这是多余的。所以我们在编码的过程中可以少用这类名词,如果要用,我们应该明确这个单词是真正的意义的,而不是多余的。

· 使用可搜索的名称

Felix:这点主要还是要我们能够写出有含意的变量名,最好不要用单个字母或数字,因为这样不助于阅读也不助于搜索。通常,我们会把常量用大写字母,单词与单词之间用下划线分隔这种方式来命名。

第三章 函数

是什么让代码易于阅读和理解? 怎么才能让隐函数表达其意图?该给函数赋予哪些属性,好让读者一年就明白函数是属于怎样的程序?

函数的第一规则是短小,第二条规则是还要短小。

Felix:小的东西更容易让人理解,这点我相信大多数人还是认同的。小的东西天生具有灵活的特性,而臃肿的东西则与生俱来就是复杂和笨重的代名词。在编程中,我始终认为,小的程序比大的程序要好。至于好在哪里,我想我都不用多说,都能轻松罗列一些显而易见的好处。灵活,易于维护,高性能(这个不是绝对的)等等。还有,通常在我们编程过程中,我信奉能够用一行代码编出的程序,绝不用两行代码来编写。当然,这是建立在写出的代码易于理解的基础上的。这点不能误解,不是说你把多行代码写在一行就是好的代码。或者是用生涩的代码来代替多行能够使人理解的代码,为了缩小代码量而牺牲了代码的可阅读性。我的意思是,当我们能够用比较简单的逻辑,或者使用封装好的方法来更精简地完成同样的功能。大家一定要吝惜自己的代码,让自己的代码能够一字值千金。

当然,也不是说函数短小就一定能给我们的项目带来好处。这还是需要结合实际情况来考虑。在实际中,我们的项目往往代码量是比较大的,如果函数变小,那么势必会增加项目的函数数量。函数变多,就会使得大量的函数分散而不好管理。那么是不是我们就没有办法来处理就个缺点呢?就目前来说,我认为最好的方法就是封装和抽象,这是面向对象思想的精髓。说到这里,封装和抽象势必也会造成类的数量的增加。多的东西势必会造成复杂,复杂必将给我们的项目维护带来困难。所以,我们的宗旨就是要将复杂的东西变简单。要想处理好散乱的东西,最好的方法就是管理。所以,我们就会使用package来管理类,使用project或者是module来管理package。有了这些层次间的管理,就会使得散乱的东西变得整洁而有序。

最后,总结一下上面的观点就是,小而不乱的代码或者函数就是值得我们青睐的好程序。

  • 发表于:
  • 原文链接http://kuaibao.qq.com/s/20180501G1EJ3P00?refer=cp_1026
  • 腾讯「腾讯云开发者社区」是腾讯内容开放平台帐号(企鹅号)传播渠道之一,根据《腾讯内容开放平台服务协议》转载发布内容。
  • 如有侵权,请联系 cloudcommunity@tencent.com 删除。

扫码

添加站长 进交流群

领取专属 10元无门槛券

私享最新 技术干货

扫码加入开发者社群
领券