问Xcode注释自动完成(appledoc样式)

EN

使用Xcode的代码片段特性。您可以使用所需的文本创建代码段，并在要填充的文本中添加项目。要创建代码片段，只需在Xcode编辑器中选择一些文本并将其拖动到代码片断库中即可。您可以设置完成快捷键，这样类似于m-comment的内容就可以成为您的标准方法注释：

​

​

键入m-comment的第一部分，然后显示整个快捷键(以及任何其他完成操作)，接受完成操作将添加一个注释，其中包含等待填充的参数化部分。像往常一样，您可以按tab键从一个切换到下一个：

​

​

您可以通过将文本的给定部分括在<#和#>中来指明它是要填充的字段，如：<#method name#>。

当然，Objective-C的优点之一是方法名通常会告诉您参数是什么。在评论中重复这一点似乎是不必要的额外工作。Xcode3对脚本有更好的支持，包括可以自动生成带参数的HeaderDoc注释的脚本。然而，它们并没有被广泛使用，可能是因为这些类型的评论并不是真正有用。