软件开发

《架构整洁之道》摘录

花了一个多月读完了这本《架构整洁之道》,跟《代码整洁之道》、《程序员的职业素养》算是一个 Clean 系列,每一本读来都很有启发。这本《架构整洁之道》有些地方看得还挺迷糊,值得一读再读。 概述、编程范式 设计与架构没有任何区别。一丁点区别都没有!软件架构的终极目标是,用最小的人力成本来满足构建和维护该系统的需求。 三种编程范式(结构化编程、面向对象编程和函数式编程)与软件架构的三大关注重点不谋而合:功能性、组件独立性以及数据管理。 面向对象编程到底是什么?对一个软件架构师来说,其含义应该是非常明确的:面向对象编程就是以多态为手段来对源代码中的依赖关系进行控制的能力,这种能力让软件架构师可以构建出某种插件式架构,让高层策略性组件与底层实现性组件相分离,底层组件可以被编译成插件,实现独立于高层组件的开发和部署。

《程序员的职业素养》读书笔记

这本书的英文名是 The Clean Coder, 中文译名是《代码整洁之道:程序员的职业素养》,跟《代码整洁之道》是同一个作者。这本书与具体的代码技巧关系不大,主要就讲了一件事——如何做一名专业的程序员。 挺薄一本书,内容都是日常所见,加上翻译也不错,所以读起来感觉轻松流畅。书中多数内容早已在实践,我印象最深刻的是这样几点:专业人士的态度,要重视测试,如何预估项目,以及对「流态区」的看法。 态度 专业人士至少应当有这样的态度:负责任,有担当。尽可能不出错,能为自己的错误负责。 测试 书中多次讲到「

apiDoc 基础语法

apiDoc 可以通过文本生成体验良好的 API 文档页面,这些文本可以以注释的形式放在代码里,apiDoc 读取源码注释,就可以生成页面了,当然也可以与代码分开,写一些全是注释的文档,作为 apiDoc 生成文档页面的「源文件」。 整理一下 apiDoc 「源文件」内容写法的“最小必要知识”。其余内容,查文档。 基础 用一个「文档块」来描述一个 API,这个「文档块」也是实现 API 的代码的注释。 一个文档块以 /** 开始,

《代码整洁之道》摘录

摘录了一些内容,跟这些内容在书中出现的顺序不同,打散又整理了一下。除了斜体字部分,都是对原书的引用。 应该有的态度 程序员遵从不了解混乱风险的经理的意愿,也是不专业的做法。 做好自己的事,尊重自己的手艺,写干净的代码。糟糕的代码引发混乱!别人修改糟糕代码时,往往会越改越烂。 碰到过“从跟上就烂”的项目代码,对这种项目的改造往往较为困难,成本很高,甚至不如推到重来。签入的代码,要比签出时整洁一点。代码应当讲述事实,不引人猜测。整洁的代码总是看起来像是某位特别在意它的人写的。聪明程序员和专业程序员之间的区别在于,专业程序员了解:明确是王道。言到意到。意到言到。如果同一段代码反复出现,就表示某种想法未在代码中得到良好的体现。 一些细节做法

《Go 语言实战》笔记

上周末翻完了《Go 语言实战》这本书,还不错,篇幅不大,内容实用。书中有很多内容是这样写的:先给出一大段代码,然后一点一点拆解分析,稍微有些啰嗦。我先把 A Tour of Go 过了一遍,再看这本书算是更深入了一点。 看书过程中,标注了一些之前忽略或者生僻或者需要刻意重复练习的——或者是有趣的——知识点(自然是不全面的),整理在这里。 init 函数 程序中每个代码文件里的 init 函数都会在 main 函数执行前调用。 一个常见的用途:在