iOS 注释方式，代码块使用

1.单行注释

/// 单行注解.
@property (nonatomic,strong)NSString *param1;
//! 单行注解.
@property (nonatomic,strong)NSString *param2;
/** 单行注解. */
@property (nonatomic,strong)NSString *param3;
/*! 单行注解. */
@property (nonatomic,strong)NSString *param4;

2.行尾注释

@property (nonatomic,strong)NSString *param1; /**< 行尾注解. */
@property (nonatomic,strong)NSString *param2; /*!< 行尾注解. */
@property (nonatomic,strong)NSString *param3; //!< 行尾注解.
@property (nonatomic,strong)NSString *param4; ///< 行尾注解.

typedef NS_ENUM(NSInteger,CouponsType){
    CouponsTypeForVouchers = 1, /**< 代金券    */
    CouponsTypeForMileage,      /*!< 里程优惠券 */
    CouponsTypeForTime,         //!< 时间优惠券
    CouponsTypeForDiscount,     ///< 折扣优惠券
};

3.多行注释

/**
 计算两个数的和
 
 @param number1 加数1
 @param number2 加数2
 @return 相加结果
 */
- (NSInteger)sumWithNumber1:(NSInteger)number1 number2:(NSInteger)number2;

4.方法集注释

#pragma mark - 初始化UI

5.注释快捷键

（1）多行注释

 Xcode8以后多行注释快捷键：[Command + Option(Alt) + /]

（2）其它注释

其它注释可以添加为代码块来快捷使用：
我们先定义一个最简单的代码块，在属性定义的位置我们写下如下代码

@property(nonatomic,strong) <#Class#> *<#object#>;

然后选中代码，按住鼠标左键，直到鼠标变成箭头，然后将其拖到xcode右边code snippets处(图1) 图1

各个属性代表意义

图中从上到下的含义依次是：
①Title
代码片段的标题
②Summary
代码片段的描述文字
③Platform
可以使用代码片段的平台，有IOS/OS X/All三个选项
④Language
可以在哪些语言中使用该代码片段
⑤Completion Shortcut
代码片段的快捷方式 例：copy 
⑥Completion Scopes
可以在哪些文件中使用当前代码片段，比如全部位置，头文件中等，当然可以添加多个支持的位置。
最后的一个大得空白区域是对代码片段的效果预览。
一切设置完成以后，点击该菜单右下角的Done按钮，新建工作就结束了。

Xcode10 自定义代码块

第一步，选中你要添加的代码块并右击

第二步，在弹出的对话框中选择“Create code Snippet”

第三步：写入你的Snippet标题和快捷实现提示字符