Xcode 注释自动完成（appledoc 风格）

我发现记录界面特别痛苦，因为我需要自己输入所有内容。所以我想我一定不是唯一一个这样的人，并开始寻找一种方法来减轻我的痛苦，但没有找到多少。

我的问题是，有没有快捷方式或方法可以让 Xcode 自动完成我的评论？例如，我非常希望输入/** + [tab]它会自动完成：

/**
 * [cursor here]
 * 
 * (maybe some pre-populate a list of arguments for the method below)
 */
- (void)test:(NSString *)testString another:(NSString *)another;

Thanks!

使用 Xcode 的片段功能。您可以使用所需的任何文本创建片段，并在文本中添加要填写的项目。要创建片段，只需在 Xcode 编辑器中选择一些文本并将其拖到片段库中即可。您可以设置完成快捷方式，例如m-comment可能是您的标准方法注释：

输入第一位m-comment然后显示整个快捷方式（以及任何其他完成），接受完成会添加一条注释，其中包含等待填写的参数化部分。像往常一样，您可以从一个选项卡跳到下一个：

您指示文本的给定部分是一个要填写的字段，方法是将其括起来<# and #>, like: <#method name#>.

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