闲话注释风格
《一个码农的自我修养》一书花了相当多的篇幅来阐述代码注释的重要性,可见注释真的很重要!好吧,其实没这本书~ 不过,应该没人能质疑注释的重要性,因为没多少人愿意接手和维护一堆纯粹的逻辑符号,虽然个人项目另当别论,但不是每个人的记忆力都能突破天际地记得“原来我曾经写过这样的代码”。所以,我个人对那些写了一堆代码没一句注释的伪牛人是嗤之以鼻的。但写这篇文章的自己可能也是相当的小题大做,其实注释只要是简明清楚,都应该来者不拒,而没必要太注重形式。一个团队还是保持某一种统一的风格比较好,在大框架下的求同存异,每个人也都应该保留适合自己的空间。 本文旨在罗列一些笔者遇到的注释,仅仅只是闲谈。每个人都有适合自己的风格,无所谓好坏。 无论是C风格的注释,还是后来C++增加的单行注释,我们都再熟悉不过了: /* Basic Comment…
《一个码农的自我修养》一书花了相当多的篇幅来阐述代码注释的重要性,可见注释真的很重要!好吧,其实没这本书~ 不过,应该没人能质疑注释的重要性,因为没多少人愿意接手和维护一堆纯粹的逻辑符号,虽然个人项目另当别论,但不是每个人的记忆力都能突破天际地记得“原来我曾经写过这样的代码”。所以,我个人对那些写了一堆代码没一句注释的伪牛人是嗤之以鼻的。但写这篇文章的自己可能也是相当的小题大做,其实注释只要是简明清楚,都应该来者不拒,而没必要太注重形式。一个团队还是保持某一种统一的风格比较好,在大框架下的求同存异,每个人也都应该保留适合自己的空间。 本文旨在罗列一些笔者遇到的注释,仅仅只是闲谈。每个人都有适合自己的风格,无所谓好坏。 无论是C风格的注释,还是后来C++增加的单行注释,我们都再熟悉不过了: /* Basic Comment…