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)

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

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

网友评论