Xcode-为Swift闭包添加自定义文档 问题: 向Xcode 8中的自定义Swift闭包添加文档（使用内置功能而非第三方）的正确格式是什么 您能提供苹果文档链接以供参考吗 如何指定闭包参数 如何指定关闭返回类型

例如：

struct S1 {

    /// This block is executed after completion
    var completion : (String, Int) -> (Bool)
}

注:

Xcode 8

内置了向自定义代码添加文档的功能

这可以通过执行以下操作之一来完成：

• 命令

  +

  选项

  +

  单击
  

• 将光标保持在代码和编辑器上

  结构

  添加文档

参考：

• 有关参考信息，请参见“格式化快速帮助”一节

解决方法： 如果给定位置不支持这些标记，那么目前唯一可能的解决方法似乎是：

struct S1 {
    
    /// description
    ///
    /// __returns__
    /// blah blah
    ///
    /// __parameters__
    /// blah blah
    var completion : (String, Int) -> (Bool)
}

---

参数和返回类型未显示。只有Swift代码的描述显示出来。啊，好了，现在我明白问题了！在我的回答中加了一段。遗憾的是，Xcode9不会改变这一点。