iOS 注释规范

iOS注释规范&&提高注释效率

iOS注释主要分为以下几种:属性注释、方法集注释、方法注释、普通注释(单行注释)。

1.属性注释


该类注释主要用于属性,变量名的注释。提高效率方法见下面代码块的使用。

2.方法集注释

方法集注释就是对多个方法进行统一注释,统一解释几个方法大体类型,特别对一些代码比较长的代码文件,在点击代码编写界面上方的代码路径后段查看代码里面所有的方法时候,可以有效的看出哪些方法进行的什么操作,从而可以快速定位方法。


方法集注释如下所示

方法集注释效率的提高见下面代码块的使用。

3.方法注释

方法注释推荐采用VVDocument插件进行注释,最新的xcode-8里面的系统文件里就有该插件的文件,足以可见这款插件是相当不错的。


VVDocument Github地址

方法注释主要对单个方法进行注释,使用VVDocument插件注释方法很简单,连续点击三次”///”就会出现注释。并且它会自动识别方法名中的变量,然后打印出来。注释最上面是对方法功能的介绍,变量名的文字是对变量名的解释。

4.普通注释

所谓普通注释就是代码片段里有一句需要解释下,和绝大多数语言一样。双斜杠进行注释。或者采用统一样式

5.代码块在注释中的使用

Xcode自带的代码块是一个非常好用的工具,可以快速的通过快捷键打出你想要的代码,代码块主要如图下所示。加入代码块的方法请百度,这里不介绍了。

下面介绍下我写的几个注释的代码块,其中title是定义的代码块名称,shortcut是快捷键。在代码中打出快捷键就回弹出相应的代码块供你选择,极大的提高代码编写效率。

1)方法集注释


2)属性注释


3)普通注释


最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,841评论 18 139
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 172,908评论 25 708
  • 快速注释 属性注释 单行注释 方法注释Xcode 8后Command + Option + /快捷键可以给方法快速...
    Eugene_iOS阅读 1,095评论 0 2
  • 文 | Molly 日剧《校对女孩河野悦子》中,折原幸人是一名小说家,以笔名写书获得新人奖而出道,但编辑和校对人员...
    Molly呢喃阅读 1,024评论 2 6
  • 精要主义不是一种教人再多做一件事情的方法,而是教人如何做事的不同方法,它是一种思维方式,但要把这种思维方式内化于心...
    冰祈依然阅读 199评论 0 0