Xcode 8自动生成的快速帮助文档

在年宣布的新功能中，我们可以看到

“自动生成快速帮助文档”：

这是不是像我们一样的手动代码文档的结尾

有人能概述一下这个新功能的优缺点吗

我找不到有关新功能的更多信息。

这是指Xcode 8（及更高版本）功能，您可以在其中选择如下方法：

func foo(bar: Int) -> String { ... }

。。。然后按⌘+选项+/（或从Xcode的“编辑器”菜单中选择“结构”»“添加文档”），它将为您生成以下注释模板：

//
///
///-参数栏：
///
///-返回：

它只是方便了快速帮助文档的编写

---

---

注意，虽然这种行为随着时间的推移已经发生了一些变化，但是当您尝试这样做时，Xcode可能会特别注意光标必须在哪里。例如，光标必须位于函数名的某个位置，在我上面的示例中，

foo

，这样才能工作。或者双击函数名，然后按⌘+选项+/

这很可能与以下事实有关：如果您的键盘需要按shift键，则所有带有“/”的热键在当前的XCode 8版本中都不起作用

也就是说，在德语键盘上，“/”是shift+7，按alt+cmd+shift-7没有任何作用。如果您指定cmd+shift+opt+d，它就可以正常工作

快捷方式“///”，不幸的是现在也不起作用，可能是由于旧的XCode插件VVDocumenter使用了这个快捷方式

---

伟大的功能，苹果方面糟糕的质量保证。

@Rob:你知道我如何在没有安装Xcode 8 bêta并在安装后立即卸载它（未经授权在我工作的mac上安装它）的情况下展示它的样子吗它在一些WWDC 2016视频中得到了演示。你可以在37:00的视频中看到一个演示-但是我无法让它真正工作！我试过使用swift和obj-c，并选择了功能的不同部分。你能让它工作吗？我不能。如果可以的话；使用该命令时，您选择了什么？我尝试了几乎所有的选项……我只是将光标放在方法名的某个位置，然后在Xcode 8中按command+option+“/”（以及选择了“编辑器”-“结构”-“添加文档”），它工作得很好。到目前为止，我遇到的唯一问题是它似乎与

@IBAction

方法相混淆。但它同时适用于Objective-C和Swift fine。如果您仍然有问题，并且尝试了重启Xcode和/或重启计算机的常规蹩脚程序，您可能只想在这个测试版软件上发布错误报告。我只是尝试了重启，但仍然没有乐趣。我已经提交了一份错误报告。它实际上从Xcode 8 beta 1开始工作，但如果您使用El Capitan，您需要启动Xcode，让它安装所需的系统组件，然后在终端中运行

sudo/usr/libexec/xpccachectl

，并在它或任何其他Xcode扩展工作之前重新启动Mac。请参阅Xcode 8发行说明。我发现它偶尔会工作。有时效果很好，有时根本不起作用。我也没有发现原因。坦白地说，当它工作时，我发现它自动生成的东西非常稀疏（描述中的方法名称？）。对于你们中那些认为它可以毫无问题地工作的人来说，太棒了。对于我们中的一些人来说，它是零星的，或者根本不起作用。Xcode 8 beta中有这个bug，但在发布的版本中已经修复了。8A218a是发布的版本-注释快捷方式对我来说再次起作用（在betas中没有）。你是在键盘布局上，在不使用shift的情况下可以得到“/”？是的，我有两个键盘，一个是法国Azerty键盘，另一个是“/”在“：”和一个美式Qwerty键盘上。这两种键盘都可以作为评论快捷键。对我来说，它是间歇性的（美式键盘）。