iOS 注释方法大全 代码块加快捷键注释

注释规范

良好的编码规范是程序员必备的素质，编码中的代码注释尤其重要，健全的代码注释能够提升代码可读性和维护性，不只为了标识此块代码的含义，不少时候包含了对业务逻辑的解释，项目中不免有逻辑复杂之处，不加注释的代码，很多天后本身看都会以为陌生，更不要说其余人看了，今天分享一下Objective-C开发中经常使用的代码注释方式以及应用场合。

注释形式

注释形式主要有：

单行注释，多行注释，方法注释，方法集注释（配合代码块实现快速注释）

1. 单行注释

使用 // 注释单行代码，最多见的使用场景是在方法内注释某个属性或某块区域的含义，以下图：

2. 多行注释

使用 /** 文本 **/ 的注释格式（快捷键cmd+alt+/）能够对属性和类以及方法进行注释，与//不一样的是，该注释方式能够写多行，通常使用在类的头文件，多行介绍当前类的含义，以下图：

3. 方法注释

与方法2相同，使用 /** 文本 **/ 的注释格式（快捷键cmd+alt+/）能够对方法进行注释，快捷键会根据方法参数自动生成须要填写的注释内容，而且在其余地方使用该方法时，Xcode会智能提示出以前写的注释内容，以下图：

在方法上方使用快捷键 cmd+alt+/：

使用该方法时显示注释内容：

4：方法集注释（配合代码块实现快速注释）

先介绍一下，何为方法集注释，一般没有添加方法集的类是这样的：

为了快速定位类中的某块代码，或某个方法，Xcode为咱们提供了方法集的注释方式，可大大减小搜寻目标代码的时间，如图：

这样就能对类中的方法和模块尽收眼底，要查找或修改的时候能够迅速定位，节省时间，提升自我体验。

实现方法：

( #pragma mark  <#注释的内容#> )

可是每次敲这些字符必定不是你想要的效果，在Xcode8以前可使用VVDocumenter加强版（我的在原基础上修改添加方法集注释功能），因为Xcode8默认禁用使用插件，因此咱们采用代码块+快捷键的方式来实现，效果也是酸爽：

上图中，就是我使用代码块+快捷键来实现的方法集注释，编写方便，快捷，具体实现步骤以下：

添加代码块并设置快捷键：

这样就大功告成，保存代码块，在代码中使用预设的快捷键，编译器会自动提示，回车，输入便可。

记得代码块预设的时候“注释内容外要用<#>” 。