代码整洁之道要点(二)

本系列出自于本人看过《代码整洁之道》后总结的一部分要点。 非常感谢这本书给我和广大程序员带来的快乐!
注: 需要该书电子版的朋友请私信我。
推荐歌曲:In The End - LINKIN PARK

注释不能美化糟糕的代码
带有少量注释的整洁而有表达力的代码,要比带有大量注释的零碎而复杂的代码像样得多。
与其花时间编写注释解释糟糕的代码,不如花时间清洁那堆糟糕的代码。

好注释
注释也有好的,比如:法律信息、提供信息的注释、对意图的解释、阐释、警示、TODO注释、放大、公共API等。

坏注释
什么是坏注释呢?坏注释就是糟糕的代码的支撑或者借口,或者对错误决策的修正。
比如:喃喃自语、头部多余的注释、误导性注释、循规式注释、日志式注释、废话注释、归属与署名、注释掉的代码。

概念间垂直方向上的区隔
每行代码展示一个表达式或者一个字句,每组代码行展示一条完整的思路,在每组代码之间用空白行区隔,这样能极大地影响到代码的视觉外观。
每个空白行都是一条线索,标识出新的独立概念。

垂直顺序
一般而言,我们想自上而下展示函数调用依赖顺序。也就是说,被调用的函数应该放在执行调用的函数下面。

横向格式
一行代码的宽度不应太宽,尽管如今显示器越来越宽。
代码的宽度最好保持在120个字符以内。

水平方向上的区域与靠近
我们在赋值操作符周围加上空格字符,在相关性较弱的事物间加上空格,能进一步强调分割效果。
乘法因子之间没加空格,因为它们具有较高优先级。加减法运算项之间用空格隔开,因为加法和减法优先级较低。

数据抽象
隐藏实现并非只是在变量之间放上一个函数层那么简单。隐藏实现关乎抽象!
类并不简单地用取值器和赋值器将其变量推向外部,而是暴露抽象接口,以便用户了解数据的实现就能操作数据的本体。

数据、对象的反对称性
过程式代码便于在不改动既有数据结构的前提下添加新函数。
面向对象代码便于在不修改既有函数的前提下添加新类。

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

斗乐八神

你的鼓励将是我最大的支持~

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值