【笔记】编写可读代码的艺术

本文为阅读《编写可读代码的艺术》的笔记，阅读原书请移步我的资源下载区

如何给变量/函数命名？

1.选专业的词，如使用DownloadPage/FetchPage替换GetPage

2.避免tmp等泛泛的词

3.循环迭代器变量的命名 metrics[mi].user[uj].name[nk]

4.避免抽象的名称 ServerCanStart()换成CanListenOnPort()

5.带单位的变量，单位写入变量名

6.附加其他属性 password变成plainPassword

7.小作用域->短名字  大作用域->长名字

8.是否可以缩写变量名，以缩写后新成员能否看懂为标准

9.去掉无用的词 ConvertToString() ->  ToString()

10.命名不能让人产生误解：Filter()到底是筛去还是筛选保留？

11.max, min表示（包含）极限

12.first, last表示（包含）范围

13.begin, end表示（排除）范围

14.命名要适当表示函数动作，不要给他人产生误解。比如要通过复杂度O(n)的操作得到size的函数，命名应该为ComputeSize()，而不是GetSize()