在目标C中，我可以使用#pragma mark符号导航器标记代码的各个部分。由于这是C预处理程序命令，因此在Swift中不可用。在Swift中有替代方法吗？还是我必须使用丑陋的注释？

您可以使用 // MARK:

也有讨论认为，无论如何，自由使用类扩展可能是更好的做法。由于扩展可以实现协议，因此您可以（例如）将所有表视图委托方法放入扩展中，并以比#pragma mark其能力更高的语义级别对代码进行分组。

直到Xcode 5，预处理器指令都#pragma mark存在。

从Xcode 6开始，您必须使用 // MARK:

这些预处理器功能允许在源代码编辑器的功能下拉框中添加一些结构。

一些例子 ：

// MARK:

->将在水平分隔符之前

// MARK: your text goes here

->在下拉列表中以粗体显示“您的文字在此处”

// MARK: - your text goes here

->在下拉列表中以粗体显示“您的文本在此处”，并在其前添加水平分隔线

更新：添加了屏幕截图，因为某些人似乎仍然对此有疑问：

对于那些对使用扩展vs.pragma标记感兴趣的人（如第一条评论中所述），下面是如何通过Swift工程师实现它：

import UIKit

class SwiftTableViewController: UITableViewController {

    init(coder aDecoder: NSCoder!) {
        super.init(coder: aDecoder)

    }

    override func viewDidLoad() {
        super.viewDidLoad()

    }
}

extension SwiftTableViewController {
    override func numberOfSectionsInTableView(tableView: UITableView?) -> Int {
        return 1
    }

    override func tableView(tableView: UITableView?, numberOfRowsInSection section: Int) -> Int {
        return 5
    }

    override func tableView(tableView: UITableView?, cellForRowAtIndexPath indexPath: NSIndexPath?) -> UITableViewCell? {
        let cell = tableView?.dequeueReusableCellWithIdentifier("myCell", forIndexPath: indexPath) as UITableViewCell;

        cell.textLabel.text = "Hello World"

        return cell
    }

}

这也不一定是最佳实践，但是如果您愿意，这就是您的做法。

Pragma mark - [SOME TEXT HERE]在Objective-C中用于将行分隔的几个功能组合在一起。

在Swift中，您可以使用MARK, TODO OR FIXME

一世。标记： //MARK: viewDidLoad

这将创建一条水平线，并将功能分组在viewDidLoad下（如屏幕截图1所示）。

ii。去做 ： //TODO: - viewDidLoad

这会将功能分组到TODO下：-viewDidLoad类别（如屏幕截图2所示）。

iii。整我 ： //FIXME - viewDidLoad

这会将功能分组到FIXME下：-viewDidLoad类别（如屏幕截图3所示）

有关详细信息，请查阅此Apple文档。

官方文件

苹果公司有关Xcode跳转栏的官方文档：在跳转栏中添加代码注释

示例代码的跳转栏屏幕截图

Xcode 10.1和macOS 10.14.3（Mojave）中的行为

Xcode 10.0和macOS 10.13.4（High Sierra）中的行为

Xcode 9.4.1和macOS 10.13.0中的行为

讨论区

!!!:而???:有时不能显示。

在Objective-C代码中，Xcode检测到的注释// MARK: - foo比注释更易于移植#pragma。但是这些似乎也没有被捡起来（还？）。

编辑：在Xcode 6 beta 4中修复。

我认为这Extensions是一种更好的方法#pragma mark。

使用之前的代码Extensions：

class ViewController: UIViewController, UICollectionViewDataSource, UICollectionViewDelegate {
    ...

    func collectionView(_ collectionView: UICollectionView, numberOfItemsInSection section: Int) -> Int {
        ...
    }

    func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
        ...
    }

    func collectionView(_ collectionView: UICollectionView, didSelectItemAt indexPath: IndexPath) {
        ...
    }
}

使用后的代码Extensions：

class ViewController: UIViewController {
    ...
}

extension ViewController: UICollectionViewDataSource {
    func collectionView(_ collectionView: UICollectionView, numberOfItemsInSection section: Int) -> Int {
        ...
    }

    func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
        ...
    }
}

extension ViewController: UICollectionViewDelegate {
    func collectionView(_ collectionView: UICollectionView, didSelectItemAt indexPath: IndexPath) {
       ...
    }
}

Xcode 8现在按以下方式处理它，并在方法下拉列表中显示如下：

今天早上在WWDC的Swift实验室中与Apple工程师确认，目前目前没有任何#pragma或同等功能，他们认为这是一个错误，并且即将发布，因此，我希望是beta 2。

无论如何，它正在路上。

Xcode现在支持// MARK :、 // TODO：和// FIXME地标来注释您的代码并在跳转栏中列出它们

#pragma_mark在Swift中添加三个选项：

1） // MARK: - your text here -

2） // TODO: - your text here -

3） // FIXME: - your text here -

注意： -用于添加分隔符

采用

// MARK: SectionName

要么

// MARK: - SectionName

这将在实用标记上方显示一行，使其更具可读性。

为简便起见，只需添加

// MARK: - <#label#>

您的代码段。

替代方式-

用这种方式使用

private typealias SectionName = ViewController
private extension SectionName  {
    // Your methods
}

这不仅会添加标记（就像编译指示一样），而且还会很好地隔离代码。

//# MARK: - Spinner Class Methods

在冒号和您的描述之间添加一行以插入分隔线。这有助于组织更多代码。上面的代码和屏幕截图使用了带有一行的MARK注释。

1. //＃MARK：–文本方法（LINE）
2. //＃标记：文本方法（无行）

这仅适用于MARK注释。

您可能也对Swift 4.2 / XCode 10编译器指令感兴趣，例如

#warning("Some string to display")

和

#error("Some error to display")

当您真的不想错过任何东西时，它可能会很有用。

专业程序员必须使用此标记才能获得良好的代码。这也有利于团队合作。

// MARK: example Web Service start here
// TODO: example 1
// FIXME: Please change BASE url before live 

很容易找到这样的方法

在Xcode 11中，他们添加了可以激活的小地图Editor -> Minimap。

Minimap将显示每个标记文本，以便在代码中快速定位。每个标记的写法都像// MARK: Variables

//MARK:在Xcode 6.3.2中似乎不适用于我。但是，这就是我要做的事情：

1）代码：

import Cocoa

class MainWindowController: NSWindowController {

    //MARK: - My cool methods

    func fly() {
    }

    func turnInvisible() {

    }
}

2）在jump bar添加//MARK：注释时，什么都没有改变。但是，如果我单击跳转栏中最右边的名称，在我的情况下MainWindowController(with a leading C icon)显示为，则将显示一个弹出窗口，显示// MARK：注释的效果，即标题为“我很酷的方法”的标题：

3）我还注意到，如果单击代码中的方法之一，则该方法将成为跳转栏中最右边的条目。为了MainWindowController(with a leading C icon)成为跳转栏中最右边的条目，我必须单击方法上方的空白。

Apple在最新版本的Building Cocoa Apps中声明，

Swift编译器不包含预处理器。相反，它利用编译时属性，构建配置和语言功能来实现相同的功能。因此，预处理器指令不会导入Swift中。

＃字符似乎仍然是您使用各种构建配置和类似内容的方式，但是看起来它们正在设法减少您对大多数预处理的需求，并将其带到其他语言功能。也许这是为了帮助Playgrounds和REPL的操作尽可能接近完全编译的代码。

添加待办事项：插入带有前缀TODO：的注释。例如：// TODO：[您的待办事项]。

添加错误修复提醒：插入带有前缀FIXME：的注释。例如：// FIXME：[您的错误修复提醒]。

添加标题：插入带有前缀MARK：的注释。例如：//标记：[您的部分标题]。

添加分隔线：要在注释上方添加分隔符，请在注释的注释部分之前添加连字符（-）。例如：//标记：-[您的内容]。要在注释下方添加分隔符，请在注释的注释部分之后添加连字符（-）。例如：//标记：[您的内容]-。

尝试这个：

// MARK: Reload TableView

func reloadTableView(){

    tableView.reload()
}

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

//MARK:  <Your comment goes here>

示例：在代码中，

//MARK: Properties

// MARK: View Life cycle

//MARK: Helper methods

这就是它出现在Xcode跳转栏中的方式。