Xcode官方文档

苹果目前的官方文档部分为可见性注释代码引入了三个注释:TODO:， FIXME:和MARK:。

最新的Xcode版本(v14.2)支持另外两个注释(虽然没有出现在官方文档中):!!:和??

注意:! !:和??:被某些Xcode版本(如v10.0)不支持，原因未知。

示例截图1 - Xcode 14.2 + macOS 13.1 (Ventura)

示例截图2 - Xcode 10.1 + macOS 10.14.3 (Mojave)

Xcode官方文档

苹果目前的官方文档部分为可见性注释代码引入了三个注释:TODO:， FIXME:和MARK:。

最新的Xcode版本(v14.2)支持另外两个注释(虽然没有出现在官方文档中):!!:和??

注意:! !:和??:被某些Xcode版本(如v10.0)不支持，原因未知。

示例截图1 - Xcode 14.2 + macOS 13.1 (Ventura)

示例截图2 - Xcode 10.1 + macOS 10.14.3 (Mojave)

苹果在最新版本的“构建可可应用程序”中表示，

Swift编译器不包括预处理器。相反，它需要 编译时属性、构建配置和 语言特性来完成相同的功能。对于这个 原因是，在Swift中不导入预处理器指令。

#字符似乎仍然是你处理各种构建配置和类似事情的方式，但看起来他们试图减少你对大多数预处理的需求，并将你转发到其他语言特性。也许这是为了帮助Playgrounds和REPL的操作尽可能接近完全编译的代码。

你可能也会对Swift 4.2 / XCode 10编译器指令感兴趣

#warning("Some string to display")

and

#error("Some error to display")

当你真的不想错过什么东西时，它可能会很有用。

Pragma标记是一种提高代码可读性的方法。pragma注释会像Xcode跳跃栏上的标签一样出现。

//MARK:  <Your comment goes here>

示例:在代码中，

//MARK: Properties

// MARK: View Life cycle

//MARK: Helper methods

这是它在Xcode跳转栏中的显示方式。

//MARK:在Xcode 6.3.2中似乎不工作。然而，这是我所做的让它工作:

1)代码:

import Cocoa

class MainWindowController: NSWindowController {

    //MARK: - My cool methods

    func fly() {
    }

    func turnInvisible() {

    }
}

2)在跳转栏中添加//MARK:注释时没有任何变化。然而，如果我点击跳转栏中最右边的名字，在我的例子中，它说的是MainWindowController(带有一个领先的C图标)，然后一个弹出窗口将显示显示//MARK:注释的效果，即一个标题说“my cool methods”:

3)我还注意到，如果我点击我的代码中的一个方法，那么这个方法就会变成跳转栏中最右边的条目。为了让MainWindowController(带有一个C图标)成为跳转栏中最右边的条目，我必须单击方法上面的空白。