《代码大全》读书笔记

说明

早就听说过这本书，但是一直没有勇气读。一方面是因为书太厚，另一方面听说是十几年前的书就没有了兴趣。

偶然在公司的书架上看到了这本书，就拿回家研究了一番。这本书涵盖了编程的方方面面（连宗教信仰问题都考虑了~），可以看出作者对每一个问题都进行了深入思考。我是带着目的去读这本书的，下面是我认为对我有思考价值的地方。

• 构建活动是软件开发中的核心活动。
• 把主要精力集中于构建活动，可以大大提高程序员的生产率。
• 软件构建的主要活动包括：详细设计、编码、调试、集成、开发者调试（包括单元测试和集成测试）。
• （隐喻）重要的研发成果常常来自类比。通过把你不太理解的东西和一些你较为理解、且十分类似的东西作比较，你可以对这些不太理解的东西产生更深刻的理解。这种使用隐喻的方法叫做“建模”。
• 隐喻把软件开发过程与其他你熟悉的活动联系在一起，帮助你更好地理解。（系统生成，培植系统）
• 有一些程序员确实知道如何进行前期工作，但是他们并没有做，因为他们不能够抵抗尽快开始编码的欲望。
• 要求一套明确的需求。明确的需求有助于用户驾驭系统的功能；有助于避免争论；有助于减少开始编码开发之后的系统变更情况。
• 构建活动的准备工作的根本目标在于降低风险。要确认你的准备活动是在降低风险，而非增加风险。
• 程序员的一部分工作是教育老板和合作者，告诉他们软件开发过程，包括在开始编码之前进行充分准备的重要性。
• 如果没有明确的问题定义，那么你可能会在构建期间解决错误的问题。
• 如果没有做完良好的需求分析工作，你可能没能察觉待解决问题的重要细节。如果需求变更发生在构建之后的阶段，其代价是「在项目早期更改需求」的20至100倍。因此在开始编码之前，你要确认“需求”已经到位了。
• 好的设计都是迭代的。你尝试设计的可能性越多，你的最终设计方案就会变得越好。
• 信息隐藏是个非常有价值的概念。通过询问“我应该隐藏写什么？”能够解决很多困难的设计问题。
• 「让阅读代码比编写代码更方便」。阅读代码的次数要比编写代码多得多，即使在开发的初期也是如此。因此，为了让编写代码更方便而降低代码的可读性是非常不经济的。
• 避免让继承体系过深。面向对象的编程方法提供了大量可以用来管理复杂度的技术。然而每种强大的工具都有其危险之处，甚至有些面向对象技术还有增加——而不是降低——复杂度的趋势。
• 创建子程序最主要的目的是提高程序的可管理性，当然也有其他一些好处。其中，节省代码空间只是一个次要原因；提高可读性、可靠性和可修改性等原因都更重要一些。
• 尽可能缩短变量的“存活”时间。
• 编写肯定形式的布尔表达式。
• 按照数轴的顺序编写数值表达式。
• 你撰写文档的目的并不在于文档本身。先写计划的关键在于，它能迫使你仔细考虑配置管理，并且把你的计划向每个人解释。文档只是你在计划并构建软件系统过程中所做的真实工作的有形副产品罢了。
• 编程过程对最终产品有深远影响。
• 合作开发要求团队成员之间进行广泛沟通，甚于同计算机的交互；而单人开发则是自我交流，其次才是与计算机。
• 编程规范一旦滥用，只会雪上加霜；使用得当则能为开发环境带来良好机制，有助于管理复杂性和相互沟通。
• 编程应基于问题域而非解决方案，这样便于复杂性管理。
• 注意警告信息，将其作为编程的疑点，因为编程几乎是纯粹的智力活动。
• 开发时迭代次数越多，产品的质量越好。
• 墨守成规的方法有悖于高质量的软件开发。请将编程工具箱中填满各种编程工具，不断提高自己挑选合适工具的能力。

思考

软件开发过程

我以前认为只有坐下来写代码，才算得上是软件开发。但是现在想想并不是这样：明确产品需求是软件开发，架构设计是软件开发，数据结构和接口设计是软件开发，写测试用例是软件开发——甚至解决线上 bug 也是软件开发。首先要有对工作流程的体系认识，明白自己在项目组、公司和行业所处的位置，才能更加专注。

信息隐藏

有次产品干预我的编码设计，让我加一个变量，并在某些时机给其赋值和重置。我一直跟她讲不用这个变量也能够满足她的需求，并不一定要这样设计。解释了半天，而且还有些动情绪。

后来想想，这个问题出在我身上。我应该明确告诉她，产品只需要告诉我做什么就足够了，而不需要指导我该怎么做。

这也算是「信息隐藏」吧 ^_ 如果产品要来干预开发的编程工作，那么就违反了「高内聚，低耦合」的原则，浪费时间精力还和产品解释不清楚。

代码的内在逻辑性

《代码大全》这本书提到了一个原则：按照数轴的顺序编写数值表达式。

我觉得写代码就像写文章一样，要有内在逻辑性。这些逻辑性不应该仅仅体现在数值的顺序上，应该体现在编码的方方面面：

1. 表示同一语义的变量，在不同函数或类中，应该被定义成同一变量名称。
2. 如果产品文档上对某些物品的定义是：体力、金币，那么在代码中定义的顺序就不能是：金币、体力。
3. 一个类中，静态变量、成员变量、函数等在位置上要有逻辑，如同一游戏的开始函数，应该在该游戏的结束函数之前。

其实编码和毕业设计写论文是一个道理，我们都是在完成一个作品。写论文时会反复推敲论文内在的逻辑性，反复推敲每一个字的使用，甚至连格式字体都要保持一致性。编码并不需要像写论文那么严谨，但是这样做却是对公司负责，更是对自己负责。

工具：适合自己就好

我纠结操作系统有一段时间了：公司电脑是 Windows 操作系统，开发环境都是 Linux 系统，而自己的笔记本是 Mac。恰好有机会换电脑装 Linux，一直犹豫是否放弃掉 Windows……

Windows 就是我的「舒适区」，有很多诸如 Everything、clipX 等小巧且能提高效率的软件。但是除去所有琐碎的原因不谈，程序员用 Linux 才能最大程度上提高生产力。使用 Linux 的好处网上多的是，我就仅谈下工作中的一个感受。

我有一个需求是：在 Java 工程中通过系统执行一段 Python 脚本，获取其输出以便后续操作。但是我本地系统是 Windows，而 Java 代码最终是要部署在 Linux 上。我不得不在 Windows 上安装并配置各种环境变量——最重要的是——我要在 Java 工程中兼容 Windows 和 Linux 两套系统，而且在本地没有办法调试。

然后就想到一个词：「大道至简」（虽然用在这里有点不合适）。其实工具适合自己就好，程序员还是应该用 Linux。

关于读书

在编程领域，我并不同意「书读百遍其义自见」这个观点。一次深入的思考，往往比读 10 遍的效果都好。

同时基础知识都是相通的，书读得越多，学习新知识的能力就越强，学习效率就越高。

其实读书仅仅是为我们提供思考的点，更多的还是需要我们自己去领悟和实践，只要用心读书和实践，就一定会有很好的效果。

我的博客即将同步至腾讯云+社区，邀请大家一同入驻：https://cloud.tencent.com/developer/support-plan?invite_code=qkur9kt9iax