新手写代码最常犯的 10 个错误
教过不少新手,也看过大量初学代码。下面这些错误几乎人人都犯过,不是能力问题,是还没养成习惯。对照自查,改掉一半,代码质量立刻上一个台阶。
1. 变量名乱起
a、temp、data1——过两天自己都看不懂。命名要能说明用途:$userName、$itemCount,多打几个字符,省的是后面每次读代码的时间。
2. 复制粘贴代码
同一段逻辑复制三次以上,就该抽成函数了。复制粘贴的代码,改需求时漏改一处,bug 找一天。
3. 不写注释,或注释全是废话
好的注释解释"为什么",不解释"是什么"。// 把 a 赋给 b 这种注释等于没有。相反,一段逻辑复杂的代码,一行"为什么这么做"的注释能救后来的自己。
4. 报错不读,直接百度
报错信息是系统给你的调试线索。先读一遍,八成问题能定位:哪一行、什么类型、缺什么。百度之前,先自己看三分钟。
5. 改了代码不测试就交付
"应该没问题"是最贵的四个字。改一行代码,把相关功能点都点一遍,五分钟的事,能挡掉大半线上事故。
6. 不做备份就动手删改
大改之前先提交一次 Git,或者复制一份文件。删掉的东西恢复不回来时,才懂备份的价值。
7. 魔术数字满天飞
代码里到处是 60、86400,不知道是什么。抽成常量并命名:const SECONDS_PER_DAY = 86400;
8. 不处理边界情况
数组为空时呢?用户输入超长呢?网络请求失败呢?代码"正常路径"能跑通不算写完,边界不出错才算。
9. 一个函数干太多事
一个 200 行的函数又读文件又算数据又发邮件,没法测也没法改。拆成小函数,每个只干一件事。
10. 出了问题先怪别人
"服务器的问题""库的 bug"。先假设是自己代码的问题,用日志和断点证明,大多数时候确实是自己的问题。这个习惯直接影响你能走多远。
这些错误没有一个是"不会"造成的,全是习惯问题。代码写得多、写得久,自然会改。但早改一年,就少踩一年坑。