Clean Code 《代码整洁之道》前四章读书笔记

第一章：

整洁的代码只做好一件事

 

减少重复代码

 

提高表达力

 

提早构建简单抽象

 

让营地比你来时更干净

 

第二章：有意义的命名

名副其实：如果名称需要注释来补充，就不算是名副其实。

 

一定要注意命名，一旦发现更好的名字，替换他

 

避免误导 比如不要用accountList，除非这真的是一个list,可以用accoutGroup等

 

这个我以后要注意

 

拼写前后规则要一致

 

废话是一种没有意义的区分，比如:Product ProductInfo ProductData

 

使用读得出来的名称，使用可搜索的名称

 

类名要尽量用名词或名词短语，方法名应当是动词或动词短语

 

全名要习惯相同，不要命名这种：controller manager driver等

尽量少的参数

最好是没有参数，或者只有一个参数

 

但有些方法天生需要两个参数 Point point = new Point(0,0);

 

书中是这样解释的：如果需要>=3个的参数，其中一些参数应该封装为类。

标识参数丑陋不堪，向函数传入bool值简直就是骇人听闻的做法

第一次听说这个理论，书中的建议是拆分为两个方法，例如：

 

1、reanderForSuite();

 

2、renderForSingleTest();

 

使用异常代替错误码

要学会用异常，这样出现新的错误码可以直接从异常类派生出来的

别重复自己，打磨代码

 

1、别给糟糕的代码加注释，重新写吧 2、程序员不能坚持维护注释 3、注释不能美化糟糕的代码

原文开始>用//TODO 形式在源代码中放置要做的工作列表

 

TODO是一种程序员认为该做，但由于某些原因目前还没有做的工作，或者要求他人注意某个问题</原文结束>

 

但是要定期查看TODO，不要使它成为一堆垃圾

 

但是公共API中的Javadoc应该有良好的注释和建议

 

坏注释： 1、自说自话，喃喃自语 2、多余的注释 3、循规式注释，毫无新意的废话 4、不要注释掉的代码放在那里

 

看到这里，我已经有点迫不及待要重构我今天写的代码了，Oh my God!