注释能使你的代码更加容易理解，更多时候注释是写给自己看的，相信我，过不了多长时间你就会把编程的思路忘记，有了注释就能加快你的思路回忆。
 一、代码注释
 很简单，就是用英文的“’”分号开头，可以单独成行，也可以注释到每句代码结束处。如：
 
Public Class ClsCustomEvent '自定义类
    'Public Delegate Sub CustomEventHandler(ByVal str As String) '声明一个事件的委托
    'Public Event CustomEvent As CustomEventHandler '声明一个自定义事件CustomEvent
    Public Event CustomEvent(ByVal str As String) '声明一个自定义事件CustomEvent
    Public Sub RaiseCustomEvent(ByVal str As String) '定义触发事件的方法
        RaiseEvent CustomEvent(str) '触发事件
    End Sub
End Class
 
注释的妙用：调试时可以把暂时不想运行的代码注释掉，这样就不用删除代码，想运行该代码再解除注释即可，不用再重新编写。
 多行注释技巧：选择需要注释的代码块，然后点击工具栏的“注释选中行”快捷按钮即可为代码添加注释，点击“取消对选中行的注释”快捷按钮可以取消对代码行的注释。
 
 二、Sub过程和Function函数注释
 在Sub过程和Function函数代码开始的上一行连续输入3个英文的分号’’’，就会自动添加注释。
 
''' <summary>
    ''' 这里写方法名称或作用
    ''' </summary>
    ''' <param name="str">这里写参数说明</param>
    Public Sub RaiseCustomEvent(ByVal str As String) '定义触发事件的方法
        RaiseEvent CustomEvent(str) '触发事件
    End Sub
    ''' <summary>
    ''' 这里写函数名称或作用
    ''' </summary>
    ''' <param name="str">这里写参数说明</param>
    ''' <param name="int">这里写参数说明</param>
    ''' <returns>这里写对返回值的说明</returns>
    Public Function a(ByVal str As String, ByVal int As Integer) As Boolean
        Return True
    End Function
 
对Sub过程和Function函数添加注释的好处在于对Sub过程和Function函数进行引用时会有相关提示，提示内容就是你所做的注释，如下图所示，这种提示的好处相信你能明白。
 
 三、窗体、模块、类头文件注释
 尔等菜鸟一直采用复制粘贴的形式来添加，其实可以在模板里添加，这样在新建窗体、模块和类时就会自动为窗体、模块和类添加文档注释。
 1、 找到你VS的安装目录：c : \Program Files (x86)\Microsoft Visual Studio 11.0。
 2、在VS安装路径下依次找到这些文件夹：\Common7\IDE\ItemTemplatesCache。
 3、接着找到\VisualBasic\Code\2052\Class文件夹下的Class.vb文件。
 说明：模块应该找到\VisualBasic\Code\2052\Module文件夹下的Module.vb文件；窗体应该找到\VisualBasic\Windows Forms\2052\Form文件夹下的Form.vb文件。
 4、用记事本或VS打开文件，在文件开头加上你想要的类头注释。如：
 
'**********************************************
'Copyright (c) $year$$registeredorganization$ All Rights Reserved.
'CLR版本： $clrversion$
'公司名称：$registeredorganization$
'命名空间：$rootnamespace$
'文件名：  $safeitemname$
'版本号：  V1.0.0.0
'版权说明：版权所有，侵权必究！
'创建人：  $username$
'电子邮箱：527516986@qq.com
'创建时间：$time$
'内容：
'功能：
'描述：
'修改日志：
'**********************************************
Public Class $safeitemname$

End Class
 
如图：
 
 5、保存文件，关闭。
 新建一个类即可看到效果，如图所示：
 
 窗体、模块、类模板里常用的参数：
 参数 描述
 clrversion 当前系统CLR版本号
 GUID [1-10] 生成全局唯一标识符,可以生成10个 (例如:guid1)
 itemname 打开添加新建项时输入的文件名称
 machinename 当前机器的名称(如:XXXX)
 registeredorganization 注册的组织名
 rootnamespace 命名空间名
 safeitemname 保存的文件名
 time 当前系统时间,格式:DD/MM/YYYY 00:00:00.
 userdomain 用户所在的域
 username 当前系统用户名
 year 当前系统时间 YYYY

      清晰明了的代码编程，可以看做是一个程序对于编程内部人员的门面。
 
     作为程序编写人员，你的代码不是给自己看的，是给其他相关程序人员看的。所以如果你想让你的代码获得他人的好感，那就必须先规范自己的代码。规范的代码编制方便代码的交流和维护，使代码美观而有逻辑，阅读方便，更易于理解。
 
    像我们现在试用的VS2012本身对于代码就有比较人性化的设计，程序人员编写的程序块或语句，它会根据内容自动缩进。而在代码中占据相当重要位置的是注释，它绝对不是可有可无的，它是程序员与日后的程序读者之间通信的重要手段。
 
          一、比如在每个程序类或者模块的开头部分的头文件就是对程序整体的说明。它的一些基本内容是必须包含的：
 

'**********************************************
' 文  件  名：$safeitemname$
' 命名空间：$rootnamespace$
' 功       能：
' 作       者：XXX
' 小       组：XX
' 生成日期：$time$
' 版  本  号：V1.0.0.0
' 修改日志：
'**********************************************
        对于编程人员来说，这个头文件是以后的编程中必须要用到的，所以就应该找个办法让其自动生成，这样就不需要每次的复制粘贴了。以我的VB.net为例，找到VS的安装位置。在这里可以对接口，对类等加入所需的头文件
 
     
     
 
       以文本文档的方式打开所在文件夹的Class.VB，将上方的头文件模板复制到其中，并保存。当再次在.NET中加入新的类时，就会自动出现了这个头文件。
 
 
                                   
 
     
 
    二、模块间的注释，如方法，属性等，需要加入注释以说明该方法或属性的用途
 
                                             
 
 
    三、代码间注释分为单行注释和多行注释：
 
           单行注释：
 
              //<单行注释>   
 
            多行注释：
 
                /*多行注释1
 
                 多行注释2
 
                 多行注释3*/
 
            代码中遇到语句块时必须添加注释（if,for,foreach,……）,添加的注释必须能够说明此语句块的作用和实现手段（所用算法、循环条件、不同分支的意义等等）。
 
 
 
      四、如果模块只进行部分少量代码的修改时，则每次修改须添加以下注释：
 
 
                                    ///修改人：
 
 
                                   ///修改日期：<YYYY-MM-DD >
 
 
                                   ///备份：
 
 
                                    /* 原代码内容*/
 
 
               将原代码内容注释掉，然后添加新代码使用以下注释：
 
 
                                   ///添加人： 
 
 
                                  ///添加日期： <YYYY-MM-DD> 
 
 
                                  代码内容
 
 
                                   ///结束：                       
 
      
 总结：大家都知道，面试时如果要想给面试官留下好的印象，最基本的就是一个人的状态或者更具体的说是一个人的着装。虽然不可否认人的内在或者说拥有的能力更加重要，但是在面试官来，他没有那么多的时间去认识你的内在，或者说如果你想让他更近一步认识你，首先你得让他对你感兴趣甚至是不反感。可想一个干净整洁的形象总是要比邋遢脏乱的形象更容易获得人们的好感度。这个道理反射到我们的代码中，其实是一样的道理。所以我们在编写代码时要从规范做起，以规范为基础，才会有更快的提高。
 

 

 
 

·注释能使注释能使代码更加容易理解，更加容易跟踪。
·出色的注释就像一幅好的设计蓝图，能够引导阅读者通过你的应用程序的曲折之处，能够说明预期的运行结果和可能出现的异常情况。
·编程原则
   ·用文字说明代码的作用
      ·编写非常出色的注释
      ·简单的重复代码做些什么没有意义
   ·用注释来说明何时可能出错和为什么出错
   ·在编写代码前进行注释
      ·编写一个过程前首先写上注释
      ·可以编写完整句子的注释或伪代码
   ·增强注释的可读性
      ·注释是供人阅读，而不是计算机阅读的，应该便于人们理解
      ·使用完整语句
      ·避免使用缩写
      ·将整个单词大写，以突出它们的重要
   ·对注释进行缩进，使之与后随的语句对齐
   ·为每个过程赋予一个注释标头
      ·采用相同的格式化方法
   ·使用内部注释来说明代码进程
      ·在每个if语句的前面加上注释
      ·在每个select case语句前面加上注释
      ·在每个循环的前面加上注释
      ·在修改了全局变量的每个语句前加上注释
             

VB 注释程序代码的符号是 '，只要在某行程序前面加上该符号就可以注释该行程序。但如果程序代码语句很多的时候，一行一行地注释就非常不方便。其实 VB 本身提供了一次性注释多条语句的功能：在主菜单“视图”选项的“工具栏”下，选中“编辑”，VB 的界面会出现一排工具按钮，其中就有用于“设置注释块”和“解除注释块”功能的按钮。选中一块语句，按该按钮即可。