1.注释类比生活
以生活中的案例来类比代码中的注释,开会时有人做的会议记录,会议记录有什么作用?当有人需要想查看会议内容时,不管他参与与否,他都可以很快地查阅会议内容。试想下如果没有会议记录呢,十天后大家都忘记地干干净净了!注释的作用相当于会议记录,让人一眼就知道当时的会议内容,当时如何讨论问题、如何解决问题、怎么下的决定。在代码上呢让别人知道代码有什么用途,当时代码为何这样设计,这么设计的好处是什么等等,不然过了很久后,很少有人会记得代码的用途。再比如手机产品说明书,它会将各个按键、手机现有功能以图形和文字形式展现出来,即使再小白的人,看看说明书中的文字和图示就可以玩转手机了。而注释就是产品说明书中的文字和图示,任何人任何时间地点,只要看着它们,就可以使用手机。
2.注释为什么要存在呢?
通过上面类比,注释的存在让我们不用担心看不懂代码,哪怕过了许久的时间,看一眼注释就知道原来代码是这样实现功能!忘记手机某个功能怎么使用的,翻开产品说明书一看,没问题了!
3.注释是什么?
注释就是备忘和说明,注释和笔记其实某种程度上是相同的,忘记这东西是干什么用的、怎么做的、当初怎么设计、怎么思考的。有价值的注释会让我们看一样就解决自己内心的疑惑。
4.注释如何表示?
Java中有单行注释//和多行注释/* */,还有文档注释,即可以生成api文档的注释,使用/** */表示。
6.注释和代码执行
注释参与代码执行吗?这问题就相当于手机播放音乐的时候,手机说明书也唱歌吗?开会的时候,会议记录也和大家一起讨论问题吗?它只是起到备忘和说明的作用,不会对会议和手机使用进行任何直接干预的。
以生活中的案例来类比代码中的注释,开会时有人做的会议记录,会议记录有什么作用?当有人需要想查看会议内容时,不管他参与与否,他都可以很快地查阅会议内容。试想下如果没有会议记录呢,十天后大家都忘记地干干净净了!注释的作用相当于会议记录,让人一眼就知道当时的会议内容,当时如何讨论问题、如何解决问题、怎么下的决定。在代码上呢让别人知道代码有什么用途,当时代码为何这样设计,这么设计的好处是什么等等,不然过了很久后,很少有人会记得代码的用途。再比如手机产品说明书,它会将各个按键、手机现有功能以图形和文字形式展现出来,即使再小白的人,看看说明书中的文字和图示就可以玩转手机了。而注释就是产品说明书中的文字和图示,任何人任何时间地点,只要看着它们,就可以使用手机。
2.注释为什么要存在呢?
通过上面类比,注释的存在让我们不用担心看不懂代码,哪怕过了许久的时间,看一眼注释就知道原来代码是这样实现功能!忘记手机某个功能怎么使用的,翻开产品说明书一看,没问题了!
3.注释是什么?
注释就是备忘和说明,注释和笔记其实某种程度上是相同的,忘记这东西是干什么用的、怎么做的、当初怎么设计、怎么思考的。有价值的注释会让我们看一样就解决自己内心的疑惑。
4.注释如何表示?
C语言中的注释有单行注释//和多行注释/* */,顾名思意,单行注释可以注释一行,多行注释可以注释多行,也包括一行。
Java中有单行注释//和多行注释/* */,还有文档注释,即可以生成api文档的注释,使用/** */表示。
6.注释和代码执行
注释参与代码执行吗?这问题就相当于手机播放音乐的时候,手机说明书也唱歌吗?开会的时候,会议记录也和大家一起讨论问题吗?它只是起到备忘和说明的作用,不会对会议和手机使用进行任何直接干预的。
7.注释是给人看的,代码是个计算机用的,我们使用注释来查看了解说明代码的。
如果零基础看到我的这篇博客,能明白注释的作用,那么我的博客就有价值了!
2016-09-20 第一次修改