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!
posted @ 2014-01-01 23:30  ConquerMobileApp  阅读(437)  评论(0编辑  收藏  举报