注释不是越多越好
很多人刚学编程时，总被老师或教程叮嘱：记得写注释！于是有人开始疯狂加注释，每行代码都配上一句“解释”，结果反而让代码更难读。其实，注释的目的不是凑数，而是帮人快速理解代码的意图。
比如你写了一行：total = price * count，再在上面写一句“计算总价”，这就多余了。变量名本身已经说明了一切，画蛇添足反而显得累赘。
什么时候该写注释
真正需要注释的地方，是那些光看代码猜不透“为什么”的地方。比如一段算法看起来绕，但它是为了解决某个特定性能问题，这时候加一句说明背景的注释就很有必要。
举个例子：
// 使用位运算替代乘法，提升高频调用下的执行效率
result = n << 1; // 相当于 n * 2这里解释了“为什么不用乘法”，这才是注释的价值所在。
好代码自己会说话
与其靠注释补救烂名字，不如直接把变量、函数起个明白的名字。比如用calculateMonthlyTax()就比func1()加一堆注释清楚得多。很多情况下，重构代码比增加注释更有效。
你在公司改一个老项目，看到满屏的// TODO: 这里有问题，以后再修，拖了三年都没人动，这种注释除了暴露拖延症，没啥用。
团队协作中的注释尺度
如果是个人小项目，注释可以随性点；但多人合作时，关键模块、接口逻辑还是得写清楚。新人接手时，看到函数上方几行清晰的说明，能省下不少问问题的时间。
像这种：
/**
* 根据用户等级返回折扣比例
* 注意：VIP3以上需二次验证才生效
*/
function getDiscount(level) { ... }既说明功能，又提醒陷阱，这才叫到位。
说到底，注释不是任务清单，不需要每一行都打卡。写多少合适？刚好能让别人（包括几个月后的你自己）看懂“为什么要这么写”，就够了。