良好的编码规范是程序员必备的素质编码中的代码注释尤为重要，健全的代码注释可以提高代码可读性和维护性不仅为了标识此块代码的含义，很多时候包含了对业務逻辑的解释项目中难免有逻辑复杂之处，不加注释的代码数日后自己看都会觉得陌生，更不要说其他人看了今天分享一下Objective-C开发中瑺用的代码注释方式以及应用场合。

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

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

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

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

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

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

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

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

这样就能对类中的方法和模块一覽无余，要查找或修改的时候可以迅速定位节省时间，提高自我体验

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

1）MARK 又叫做代码标注，我们可以使用它来添加一些说明文字同时可以选择其上方是否需要显示分割线。

// MARK: 业务处理相关方法（上方不带分割線）

// MARK: - 数据请求相关方法（上方会带个分割线）

（1）当我们写代码时如果有一些功能需要以后添加或者补全，那么就可以使用 TODO 关键字来标記提醒

（1）通常我们在 bug 的位置使用 FIXME 做标记，提醒我们稍后需要进行修改
// FIXME: 参数不正确时会导致崩溃