请问,阅读源码时,已有的代码注释究竟是促进学习还是阻碍学习

我觉得,注释明显帮助了你学习,尤其是在你还是新手或者源码是个精心架构的项目的时候(比如Linux 内核)而且,注释还可以帮助你理解作者的想法,更容易找到突破口(比如,它解决了哪些问题,又有哪些问题没有解决)反正,我在看PHP CMS 和 框架 的时候,很希望有个注释(可惜,我都没有碰到,而是开发文档,也凑合着用吧)
■网友的回复
谢邀。问题不是很详细,但是引起我某些同感(可能和提问者的感受相同,也可能不同),所以按照我的感受答一下。我相信最初有这类感觉是来自应试教育:老师总是告诉我们,不要看答案,要自己做。但,那种实践也就限于应试教育 —— 用盲测来不断揣测出题人的思路。真实世界,靠的是大量的案例来体会业界整体的习惯,标准,体会某些著名开发者和社区的文化。就像福尔摩斯说的,如果你看过一千个案例,那你遇到的第一千零一个案件不可能是悬案。没有必要从头自己破一千个案件。
■网友的回复
源代码才是最好最准确的注释注释是人们为了快速理解源代码而附加的文档,它可能不同步,也可能很准确。它的质量在阅读之前是无法得到保证的。单纯的问注释对学习有益还是有害并不科学。在学习代码的时候,掌握代码的结构和思想是很重要。阅读注释是一种快捷理解掌握的方法,但并非不可替代,而且不可靠,特别要记住注释本身就可能是错的。套冯东同学的句式来说就是,没有必要从头自己破一千个案件,但是要具备自己破一千个案件的能力。
■网友的回复
如果是解释“为什么”的注释可以看,这也是注释的主要作用;如果只是解释“这是做什么”,就不用看了,注释和代码不一致你也晕了。
■网友的回复
注释是促进了学习,反过来,如果是阻碍了学习,你完全可以不看,对吧?我的理解是,代码水平在你的水平之上,而且超过好几个级别,注释是绝对必需的,这是超出你的理解范畴的,注释能够以绝对的速度优势帮你理解代码。如果代码水平在你之下,但是写得很清晰,那注释是没有大作用的,但不会阻碍你,对吧?如果代码有点糟糕,那注释是帮你理清头绪,如果是业务相关的,那就是更加有用了。
■网友的回复
看个人吧,,我就觉得很有用

■网友的回复
因人而异。但我还是说,是阻碍。这也许是你想看到的答案。
■网友的回复
取决于注释的质量。好的注释甚至可以让你发现程序中的bug。Annotation的产生大抵也是如此吧
■网友的回复
注释的作用很多:
1,解释代码的意义
2,标注逻辑
3,错误,容易错误的地方或者容易出现bug的地方标记
【请问,阅读源码时,已有的代码注释究竟是促进学习还是阻碍学习】