Trong Mục tiêu C, tôi có thể sử dụng #pragma markđể đánh dấu các phần trong mã của mình trong bộ điều hướng biểu tượng. Vì đây là lệnh tiền xử lý C, nên nó không có sẵn trong Swift. Có một điểm nhấn cho điều này trong Swift, hay tôi phải sử dụng những bình luận xấu xí?

Bạn có thể dùng // MARK:

Cũng đã có cuộc thảo luận rằng việc sử dụng tự do các phần mở rộng lớp có thể là một cách thực hành tốt hơn. Vì các tiện ích mở rộng có thể thực hiện các giao thức, ví dụ, bạn có thể đặt tất cả các phương thức ủy nhiệm trong chế độ xem bảng của mình vào một tiện ích mở rộng và nhóm mã của bạn ở mức ngữ nghĩa nhiều hơn #pragma markkhả năng.

Lên đến Xcode 5 chỉ thị tiền xử lý #pragma marktồn tại.

Từ Xcode 6 trở đi, bạn phải sử dụng // MARK:

Các tính năng tiền xử lý này cho phép đưa một số cấu trúc vào hộp thả xuống của trình soạn thảo mã nguồn.

vài ví dụ :

// MARK:

-> sẽ được đi trước bởi một dải phân cách ngang

// MARK: your text goes here

-> đặt 'văn bản của bạn ở đây' in đậm trong danh sách thả xuống

// MARK: - your text goes here

-> đặt 'văn bản của bạn ở đây' in đậm trong danh sách thả xuống, trước một dải phân cách ngang

cập nhật: thêm ảnh chụp màn hình 'vì một số người dường như vẫn có vấn đề với điều này:

Đối với những người quan tâm đến việc sử dụng tiện ích mở rộng so với dấu pragma (như đã đề cập trong nhận xét đầu tiên), đây là cách triển khai từ Kỹ sư 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
    }

}

Đây cũng không hẳn là cách thực hành tốt nhất, nhưng đây là cách bạn làm nếu bạn muốn.

Pragma mark - [SOME TEXT HERE]đã được sử dụng trong Objective-C để nhóm một số chức năng lại với nhau bằng cách tách dòng.

Trong Swift bạn có thể đạt được điều này bằng cách sử dụngMARK, TODO OR FIXME

Tôi. DẤU : //MARK: viewDidLoad

Điều này sẽ tạo một đường ngang với các chức năng được nhóm lại dưới viewDidLoad (hiển thị trong ảnh chụp màn hình 1)

ii. LÀM : //TODO: - viewDidLoad

Điều này sẽ nhóm chức năng trong TODO: - danh mục viewDidLoad (hiển thị trong ảnh chụp màn hình 2)

iii. CỐ ĐỊNH: //FIXME - viewDidLoad

Điều này sẽ nhóm chức năng trong FIXME: - danh mục viewDidLoad (hiển thị trong ảnh chụp màn hình 3)

Kiểm tra tài liệu táo này để biết chi tiết.

Tài liệu chính thức

Tài liệu chính thức của Apple về Xcode Jump Bar: Thêm chú thích mã vào thanh nhảy

Jump Bar Ảnh chụp màn hình cho Mã mẫu

Hành vi trong Xcode 10.1 và macOS 10.14.3 (Mojave)

Hành vi trong Xcode 10.0 và macOS 10.13.4 (High Sierra)

Hành vi trong Xcode 9.4.1 và macOS 10.13.0

Thảo luận

!!!:và ???:đôi khi không thể được hiển thị.

Trong mã Objective-C, Xcode phát hiện các bình luận giống như // MARK: - foodi động hơn một chút so với #pragma. Nhưng những thứ này dường như cũng không được chọn (chưa?).

Chỉnh sửa: Đã sửa trong Xcode 6 beta 4.

Tôi nghĩ Extensionslà một cách tốt hơn thay vì #pragma mark.

Mã trước khi sử dụng 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) {
        ...
    }
}

Mã sau khi sử dụng 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 hiện xử lý nó như sau và hiển thị như thế này trong trình đơn thả xuống phương thức:

Đã xác nhận với một Kỹ sư Apple trong phòng thí nghiệm Swift sáng nay tại WWDC rằng hiện tại không có bất kỳ #pragma nào hoặc tương đương, họ coi đây là một lỗi và nó sẽ đến sớm, vì vậy tôi đoán là beta 2, tôi hy vọng.

Dù sao, nó đang trên đường.

Xcode hiện hỗ trợ // MARK:, // TODO: và // FIXME để chú thích mã của bạn và liệt kê chúng trong thanh nhảy

Có ba tùy chọn để thêm #pragma_markvào Swift:

1) // MARK: - your text here -

2) // TODO: - your text here -

3) // FIXME: - your text here -

Lưu ý: Sử dụng -để thêm dấu phân cách

Sử dụng

// MARK: SectionName

hoặc là

// MARK: - SectionName

Điều này sẽ đưa ra một dòng trên dấu pragma, làm cho nó dễ đọc hơn.

Để dễ dàng chỉ cần thêm

// MARK: - <#label#>

để đoạn mã của bạn.

Cách khác -

Sử dụng nó theo cách này

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

Điều này sẽ không chỉ thêm dấu (giống như dấu pragma) mà còn phân tách mã độc đáo.

//# MARK: - Spinner Class Methods

Thêm một dòng giữa dấu hai chấm và mô tả của bạn để chèn một dòng phân cách. Điều này giúp tổ chức mã của bạn nhiều hơn. Mã và ảnh chụp màn hình ở trên sử dụng nhận xét Mark với một dòng đi kèm.

1. // # MARK: - Phương thức văn bản (LINE)
2. // # MARK: Phương thức văn bản (KHÔNG LINE)

Điều này chỉ hoạt động với các bình luận Mark.

Bạn cũng có thể quan tâm đến các chỉ thị của trình biên dịch Swift 4.2 / XCode 10 như

#warning("Some string to display")

và

#error("Some error to display")

Nó có thể hữu ích khi bạn thực sự không muốn bỏ lỡ điều gì.

Lập trình viên chuyên nghiệp phải được sử dụng thẻ này cho mã tốt. Nó cũng tốt cho công việc nhóm.

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

Rất dễ tìm thấy phương pháp như thế này

Trong Xcode 11, họ đã thêm minimap có thể được kích hoạt Editor -> Minimap.

Minimap sẽ hiển thị từng văn bản đánh dấu để định hướng nhanh trong mã. Mỗi nhãn hiệu được viết như// MARK: Variables

//MARK:dường như không hoạt động với tôi trong Xcode 6.3.2. Tuy nhiên, đây là những gì tôi đã làm để làm cho nó hoạt động :

1) Mã:

import Cocoa

class MainWindowController: NSWindowController {

    //MARK: - My cool methods

    func fly() {
    }

    func turnInvisible() {

    }
}

2) Không jump barcó gì thay đổi khi thêm //MARK: bình luận. Tuy nhiên, nếu tôi nhấp vào tên ngoài cùng bên phải trong thanh nhảy, trong trường hợp của tôi, nó MainWindowController(with a leading C icon)sẽ hiển thị các hiệu ứng của // MARK: bình luận, cụ thể là một tiêu đề có nội dung "Phương thức tuyệt vời của tôi":

3) Tôi cũng nhận thấy rằng nếu tôi nhấp vào một trong các phương thức trong mã của mình, thì phương thức đó sẽ trở thành mục nhập ngoài cùng bên phải trong thanh nhảy. Để có MainWindowController(with a leading C icon)được mục nhập đúng nhất trong thanh nhảy, tôi phải nhấp vào khoảng trắng phía trên phương thức của mình.

Apple tuyên bố trong phiên bản mới nhất của Ứng dụng xây dựng ca cao ,

Trình biên dịch Swift không bao gồm bộ tiền xử lý. Thay vào đó, nó tận dụng các thuộc tính thời gian biên dịch, xây dựng cấu hình và các tính năng ngôn ngữ để thực hiện cùng chức năng. Vì lý do này, các chỉ thị tiền xử lý không được nhập trong Swift.

Ký tự # dường như vẫn là cách bạn làm việc với các cấu hình xây dựng khác nhau và những thứ tương tự, nhưng có vẻ như họ đang cố gắng cắt giảm nhu cầu của bạn đối với hầu hết quá trình tiền xử lý và chuyển bạn sang các tính năng ngôn ngữ khác hoàn toàn. Có lẽ điều này là để hỗ trợ cho hoạt động của Sân chơi và REPL hoạt động gần nhất có thể với mã được biên dịch đầy đủ.

Thêm một mục việc cần làm: Chèn một nhận xét với tiền tố TODO :. Ví dụ: // TODO: [mục việc cần làm của bạn].

Thêm lời nhắc sửa lỗi: Chèn nhận xét với tiền tố FIXME :. Ví dụ: // FIXME: [nhắc nhở sửa lỗi của bạn].

Thêm một tiêu đề: Chèn một bình luận với tiền tố Mark :. Ví dụ: // MARK: [tiêu đề phần của bạn].

Thêm một dòng phân cách: Để thêm một dấu phân cách phía trên chú thích, hãy thêm dấu gạch nối (-) trước phần chú thích của chú thích. Ví dụ: // MARK: - [nội dung của bạn]. Để thêm dấu phân cách bên dưới chú thích, hãy thêm dấu gạch nối (-) sau phần chú thích của chú thích. Ví dụ: // MARK: [nội dung của bạn] -.

Thử cái này:

// MARK: Reload TableView

func reloadTableView(){

    tableView.reload()
}

Dấu hiệu thực dụng là một cách để cải thiện khả năng đọc mã của bạn. Các bình luận pragma sẽ xuất hiện như các thẻ trên thanh nhảy Xcode.

//MARK:  <Your comment goes here>

Ví dụ: Trong mã,

//MARK: Properties

// MARK: View Life cycle

//MARK: Helper methods

Đây là cách nó sẽ xuất hiện trong thanh nhảy Xcode.