ios - Swift 注释 "Tag"

Question

自从 Objective-C 以来，我就是 #pragma MARK: 的粉丝，但最近我在 Apple 的源代码中看到了 ///-Tag:。另外值得注意的是，它以白色突出显示，而 MARK 则不是。另一侧的 Tag 不会向 Xcode 的“大纲” View 添加任何文本。

谁能解释一下Tag的用途是什么？

Answer 1

-Tag:注解用于定位自己代码的具体位置。您可以将其作为 symbols documentation in Swift 的一部分包含在内.例如。你可以在函数旁边的某个 Swift 文件中添加一个 Tag 标记:

/// - Tag: myFunction
func myFunction() {
  print("My function is called")
}

在另一个文件中，您可以引用代码中的这个确切位置作为另一个 Swift 实体文档的一部分:

/// Uses [myFunction](x-source-tag://myFunction) internally
func anotherFunction() {
  myFunction()
}

当在 Xcode 中的 anotherFunction 上使用快速帮助弹出窗口时，您会得到一个交互式引用(在 myFunction 文本下)，它将您带到文件(和行)，其中///- 标签:myFunction 位于: