新手写代码最常犯的 10 个错误

编程心得 2026-09-05 8 浏览

教过不少新手,也看过大量初学代码。下面这些错误几乎人人都犯过,不是能力问题,是还没养成习惯。对照自查,改掉一半,代码质量立刻上一个台阶。

1. 变量名乱起

atempdata1——过两天自己都看不懂。命名要能说明用途:$userName$itemCount,多打几个字符,省的是后面每次读代码的时间。

2. 复制粘贴代码

同一段逻辑复制三次以上,就该抽成函数了。复制粘贴的代码,改需求时漏改一处,bug 找一天。

3. 不写注释,或注释全是废话

好的注释解释"为什么",不解释"是什么"。// 把 a 赋给 b 这种注释等于没有。相反,一段逻辑复杂的代码,一行"为什么这么做"的注释能救后来的自己。

4. 报错不读,直接百度

报错信息是系统给你的调试线索。先读一遍,八成问题能定位:哪一行、什么类型、缺什么。百度之前,先自己看三分钟。

5. 改了代码不测试就交付

"应该没问题"是最贵的四个字。改一行代码,把相关功能点都点一遍,五分钟的事,能挡掉大半线上事故。

6. 不做备份就动手删改

大改之前先提交一次 Git,或者复制一份文件。删掉的东西恢复不回来时,才懂备份的价值。

7. 魔术数字满天飞

代码里到处是 6086400,不知道是什么。抽成常量并命名:const SECONDS_PER_DAY = 86400;

8. 不处理边界情况

数组为空时呢?用户输入超长呢?网络请求失败呢?代码"正常路径"能跑通不算写完,边界不出错才算。

9. 一个函数干太多事

一个 200 行的函数又读文件又算数据又发邮件,没法测也没法改。拆成小函数,每个只干一件事。

10. 出了问题先怪别人

"服务器的问题""库的 bug"。先假设是自己代码的问题,用日志和断点证明,大多数时候确实是自己的问题。这个习惯直接影响你能走多远。

这些错误没有一个是"不会"造成的,全是习惯问题。代码写得多、写得久,自然会改。但早改一年,就少踩一年坑。