请前辈们帮我看看注释写得是否规范

图片说明

这种注释对于学习写程序来说的人有用,但是对于真正的程序来说没用。
注释不是把每行代码用中文再写一遍,任何程序员都可以得到这些表面的信息。注释应该少而精炼,强调程序的实现意图和接口的调用规范。

给程序添加注释是帮助别人理解代码, 像你这样几乎每行都有注释, 反而会增加别人阅读时困难. 注释只需要加载需要加的地方帮助别人理解代码.
像下面这种注释根本不需要添加:
X x(5); Y(y); Z(z); //实例化对象

网上有windows操作系统泄露的源代码,还有liunx的源代码,mfc的源代码,各种开源软件的源代码,你可以对照看看它们,去理解我说的少而精炼是什么意思。
另外你的格式过于拘谨了,其实也没有必要。如果你看windows泄露的源代码,你会发现人家很有幽默感滴。里面甚至有各种开玩笑、调侃、抱怨和看上去扯淡的东西。

上面说的很对,不过实际工作中有些人没有写注释的习惯(比较坑),让后面的人看的很头疼。

给别人看,如果不是为了防止别人的,写详细点;
如果是防止别人盗取的,就用"无字天书"来注释。
如果是写给自己看的,写的自己看着舒服明白就可以了。

注释太多了,不能瞬间感觉到重点的注释信息在哪里

我个人认为,注释不一定就是这种形式,高层次的注释应该是让你的变量和函数等标识符见名知意,对于各个逻辑处理的地方给出简明扼要的提示。

感觉注释太复杂了吧。看不到要点

感觉注释太复杂了吧。看不到要点

个人感觉注释不需要多,明确就好。
注释在函数上说明参数返回值及作用。
当然,如果变量名和函数名取得好,注释也不用了。

注释太多了反而会起到相反的作用,让人看着不是那么利索!
注释要写到点上,不是每一行都要写注释的。

很详细
但太多了

可以简要概述,大致要实现的功能,然后几个重要的步骤,和难理解的地方注释以下就行