百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术教程 > 正文

《代码整洁之道》阅读整理,附脑图

csdh11 2025-01-26 21:47 30 浏览

这是一本半小时即可读完的书,内容不多,不抓细节,阅读体验挺好。

书中亮点

  1. “晚点弄”等于“再也不弄”。
  2. 程序员遵从不了解混乱代码风险的经理的意愿,这是不专业的做法。
  3. 编写整洁代码的程序员就像是艺术家,他能用一系列变化把一块白板变作优雅代码构成的系统。
  4. 糟糕代码的理由:一、需求变化背离了初期设计;二、进度太紧张,没法干好活。
  5. 糟糕代码的作用:一、维护周期越来越长;二、修复后无法发现的 bug 越来越多;三、最终被时间拖死了产品。
  6. 读与写的比例大概为10:1。
  7. 让代码比你看的时候更干净。
  8. 糟糕代码造成的时间/生产力曲线,如下。

整洁代码

不同人员的定义:

  • Bjarne Stroustrup C++之父:
  1. 代码逻辑应当直截了当,叫缺陷难以隐藏。
  2. 尽量减少依赖关系,使之便于维护。
  3. 依据某种分层战略完善错误处理代码。
  4. 性能调至最优,省得引诱别人做没规矩的优化。
  5. 糟糕的代码引发混乱!别人修改糟糕的代码时,往往会越改越乱。
  6. 细节上花心思,如内存泄漏、静态条件代码、前后不一致的命名方式。
  7. 整洁的代码力求集中。每个函数、每个类和每个模块都全神贯注于一事,完全不受四周细节的干扰和污染。
  • Grady Booch《面向对象分析与设计》作者
  1. 整洁的代码简单直接。
  2. 整洁的代码如同优美的散文。
  3. 整洁的代码从不隐藏设计者的意图,充满了干净利落的抽象和直截了当地控制语句。
  • Dave Thomas,OTI 公司创始人,Eclipse 战略教父
  1. 它应当有单元测试和验收测试。
  2. 它使用有意义的命名。
  3. 它只提供一种而非多种做一件事的途径。
  4. 它只有尽量少的依赖关系,而且要明确地定义和提供清晰、尽量少的 API。
  5. 代码应通过其字面表达含义,因为不同的语言导致并非所有必需信息均可通过代码自身清晰表达。

没有测试的代码不干净。不管它有多优雅,不管有多可读、多易理解,微乎测试,其不洁亦可知也。

  • Michael Feathers《修改代码的艺术》作者

整洁的代码总是看起来像是某位特别在意它的人写的。

  • Ron Jeffries《极限编程实施》及《C#极限编程探险》作者
  1. 能通过所有测试。
  2. 没有重复代码。
  3. 体现系统中的全部设计理念。
  4. 包括尽量少的实体,比如类、方法、函数等。

消除重复和提高表达力让我在整洁代码方面获益良多。

减少重复代码,提高表达力,提早构建简单抽象。

命名

  • 花时间命名,因为省下来的时间更多。如果有更好的命名,则尽快替换,这样后续读者会更加的愉悦。
  • 如果命名需要注释,那么这个命名就是糟糕的。
  • 不要无意义的命名前后缀。如 account === accountInfo,theAccount === account,这样的就是无意义的前后缀。
  • 特定用途的数字使用命名特指,起码好找不是么?let tempFour = 4 与 const TEMP_FIVE = 5 这样难道不是更好整理与查找么?
  • 专业程序员明确是王道,专业程序员善用其能,编写其他人能理解的代码。
  • 类名不应该是动词。
  • 方法名应该是动词或动词短语。
  • 统一概念词。如HTTP、Fetch、Controller、do、get、post等,不要多词同义。
  • 使用解决问题领域名称命名。比如做数学工具,总不能使用杀猪词吧。
  • 如果混淆语境,则最好封装成class。比如属性state,都叫这个就分不清了,套个class挺好。
  • 不要乱加语境。命名就是 China 的项目,还要给私有类加上 China 前缀么。

函数

  • 函数的第一规则是要短小。第二条规则是还要更短小。
  • 函数应该做一件事。做好这件事。只做这一件事。
  • 尽量单一参数,不要超过三个参数。
  • 尽量保证函数有返回值,方便拓展为纯函数。
  • 少用标识参数,如true,false这种。可以干脆分裂为两个函数。
  • 同样的入参返回同样的结果。避免副作用。

相关推荐

知名软件变“木马”:2小时感染10万电脑

近日,腾讯电脑管家监测发现,一款通过“驱动人生”升级通道,并同时利用“永恒之蓝”高危漏洞传播的木马突然爆发,仅2个小时受攻击用户就高达10万。腾讯电脑管家可精准拦截该病毒攻击,管家团队也将持续跟踪该款...

腾讯电脑管家发布病毒预警:“驱动人生木马”爆发,2小时感染10万台电脑

新华网天津12月15日电(记者周润健)腾讯电脑管家15日紧急发布病毒预警,14日下午,腾讯电脑管家监测发现,一款通过“驱动人生”升级通道,并同时利用“永恒之蓝”高危漏洞传播的木马突然爆发,仅2个小时受...

全新“撒旦”勒索病毒来袭 瑞星推出独家解密工具

新华社北京7月26日电瑞星威胁情报平台近日发现多起国内用户感染“撒旦”勒索病毒事件。据瑞星安全研究人员介绍,该病毒运行后会加密受害者计算机文件,加密完成后会用中英韩三国语言索取1个比特币作为赎金,并...

新勒索病毒“WannaCry”疯狂来袭 乌克兰副总理电脑中招

据外媒报道,从6月27日开始,一种新勒索病毒再次疯狂来袭,已席卷欧洲多个国家,连乌克兰副总理的电脑都已中招。报道称,这轮病毒足以与五月席卷全球的勒索病毒“WannaCry”的攻击性相提并论。该病毒代号...

蠕虫病毒利用“永恒之蓝”漏洞传播 单位局域网受威胁最大

日前,火绒安全团队通过“火绒威胁情报系统”发现蠕虫病毒“Worm/Sharp”正在全网传播,其中在政府、企业、学校、医院等单位的局域网具有非常强的传播能力。该病毒通过“永恒之蓝”漏洞、多个电脑常用端口...

新病毒爆发:利用“永恒之蓝”传播,2小时感染10万台电脑挖矿

驱动人生发布的声明。据腾讯安全专家介绍,通过追溯病毒传播链发现,该病毒自12月14日约14点,利用“驱动人生”、“人生日历”等软件最早开始传播,另有约30%的传播通过“永恒之蓝”漏洞在局域网内进行主动...

逍遥安卓模拟器定制手游电脑版 手机电脑账号完全互通

从今年起大量回合制端游转向手游方向,无论是《梦幻西游》、《大话西游》、《神武》还是刚刚发行的《问道》手游,都是非常重度需要大量时间来做任务挂机升级的游戏。很多人习惯了端游的时候一个电脑可以多开的玩法,...

安卓模拟器绿色U盘移动版 公司玩游戏无痕迹

安卓模拟器已经不稀奇了!随着安卓手游的盛行,特别是《梦幻西游手游》之类的重度手游发布,玩手游花的时间也越来越多。用手机玩这些游戏存在着屏幕小、点量少、费流量还有容易被电话打断,在电脑上用安卓模拟器玩游...

苹果推出 iCloud 照片和视频转移服务:可转移至谷歌相册

IT之家3月4日消息据MacRumors今日报道,苹果公司本周推出了一项新服务,帮助iCloud用户方便快捷的将其存储的照片和视频转移到谷歌照片上。苹果在其支持文档中表示,用户可以登...

NAS PK台,4核带m.2的威联通TS-264C vs 双核TS-462C

因为618年中大促看到威联通TS-264C和TS-462C这两机型售价差不多,就做个比较以供参考。毕竟作为自2007年以来就一直卖威联通的NAS老油来说,对威联通各NAS机型的识别还是相当全面的,对不...

前端学AI(七):构造 RAG 系统评估测试数据集

引言在基于DeepSeek+Chroma+LangChain开发一个简单RAG系统...

惨重教训!调查显示挪威“英斯塔”号宙斯盾舰撞油轮后本不必“丧命”

最新公布的调查报告显示,挪威皇家海军“英斯塔”号护卫舰2018年11月与油轮相撞后,如果其舰员接受了更好的损管训练,并且对舰艇的稳定特性更加熟悉的话,这艘宙斯盾型战舰本来是可以挽救的。↑挪威“英斯塔”...

「必买」盘点2021年男人们的败家清单,越“败”越香

心里总想买点啥?看看《必买》,全网最有料的场景种草指南。草原割不尽,春风吹又生。在过去的2021年,不断被各种数码产品种草,一直在买买买,剁手不停。大部分产品都经过详细的对比做足了功课,也有部分是一时...

实现浏览器播放rtsp视频流的解决方案

有同学问道:需要实时播放摄像头rtsp视频流,而浏览器不能直接播放,怎样解决?实现这个需求可以通过插件或者转码来实现。要实现这个目的,可以采用的方案非常得多,有商业的也有开源的,这里主要列举一些开源的...

ISO9000你知道多少?

1ISO9000族标准是什么?ISO9000族标准是指由国际标准化质量管理和质量保证技术委员会(ISO/TC176)制订的所有国际标准。ISO9000族标准可帮助各种类型和规模的组织实施并有效运行质...