摘要：格式是特别重要的，如果没有好的格式，我们前面的努力就会事倍功半。我们在格式上应该做到：当有人查看底层代码时，他们会被代码整洁、一致及所感知到对细节的关注而震惊。 “让代码工作”固然重要，但是对于一个开发者来说格式的目的在于沟通，好的格式有利于开发者之间的沟通，而沟通是专业开发者的头等大事。 垂直格式 阅读全文

摘要：注释是对程序代码的补充，是一种不得已而为之的行为。所以，在我们需要给程序添加注释之前一定要认真考虑一下程序是否符合前面几节提到的原则。试着想一下可否通过优化程序流程，结构优化，或者取一个合适的名字，从而使程序变得易读。 总之，尽量不要添加注释。 但是，随着工作的时间越长我们什么事都会遇到，也会遇到不 阅读全文

摘要：函数是所有软件的基本单元，也是开发人员在编程时编写的最小模块。所以，《Clean Code》为我们编写函数提供了一些规则。 在编写函数是应该遵守以下一些原则： 1 短小 函数短小的好处就是一目了然，一眼就能看出函数所实现的功能。 再者，在if语句、else语句、while语句等，其中的代码块应该只有 阅读全文

摘要：变量、函数、参数、类和封包，这些在编程的过程中都需要我们命名。程序编写好了之后，jar文件、war文件和ear文件的命名。 既然命名在软件中如此重要，那么我们在取名字的时候要遵循什么样的规则呢？《Clean Code》总结了如下几点： 1) 名副其实：名称应该已经回答了所有的大问题，即名字应该表示变 阅读全文

摘要：最近在看Robert C.Martin所著的《Clean Code》（《代码整洁之道》，韩磊翻译），觉得这本书应该是作为一个软件开发人员，尤其是码农，必读的书。这篇博文是《Clean Code》第一章的读书笔记，以后还会陆续写其他篇章的读书笔记。 第一章 整洁代码 代码是一定会存在下去的，因为将需求 阅读全文