第一章作业
1.命名
变量和函数用小驼峰:studentGrade、calculateAverage()
类名用大驼峰:StudentManager、ScoreAnalyzer
常量全大写加下划线:MAX_CONNECTION、DEFAULT_TIMEOUT
尽量不用拼音,也不要用无意义的缩写
函数名最好包含动词,calculateAverageScore() 比 process() 清楚太多
一个判断标准:如果隔一周回来看这个名字,还能立刻知道它是干什么的,就算合格。
2.注释
函数头注释说明用途、参数含义、返回值
复杂逻辑处记录设计原因或思路,尤其是看起来“绕”的地方
不写那种复述代码本身的注释,可以写一些为什么采用这个方法的原因
3.格式与排版
缩进用 4 个空格,不混用 Tab 和空格
每行代码控制在 80–120 字符以内,超了折行
用空行分隔逻辑段落:变量声明和执行代码之间、两个函数之间
运算符两侧加空格,逗号后面加空格
4.模块化
一个函数只负责一个明确的任务:读数据、算结果、输出,拆开写
函数参数不宜过多,超过 4 个就考虑封装成对象
重复出现的代码抽成独立函数
5.错误处理
用 try-catch 捕获,并记录有意义的信息
绝不写空的 catch 块,那等于把问题藏起来
捕获后要么处理,要么向上抛出,不要既不处理也不抛
浙公网安备 33010602011771号