[Xcode10 实际操作]九、实用进阶-(3)给代码方法添加宏注释

本文将演示如何在方法列表中，对方法名称进行注释。

这样可以使程序，按功能分块，使方法清晰、易读并且方便定位。

在项目导航区，打开视图控制器的代码文件【ViewController.swift】

 1 import UIKit
 2 
 3 class ViewController: UIViewController {
 4 
 5     //MARK:-
 6     //MARK:viewDidLoad
 7     
 8     //给当前方法添加编译器指令，MARK右侧的横线符号，表示将在方法列表中，显示一条分割线
 9     //添加方法的注释文字：viewDidLoad
10     override func viewDidLoad() {
11         super.viewDidLoad()
12         // Do any additional setup after loading the view, typically from a nib.
13         
14         //在视图完成加载的方法中调用下文方法
15         self.addImage()
16     }
17     
18     //MARK:-
19     //MARK:Do the main thing
20 
21     //使用上文相同的方式，给方法添加注释
22     //创建一个方法，
23     func addImage()
24     {
25         //从项目资源文件夹中载入一张图片素材
26         let image = UIImage(named: "Pic")
27         //初始化一个图像视图，并为图像视图设置需要显示的图片
28         let imageView = UIImageView(image: image)
29         //设置图像视图位于(40,80),尺寸为(240,360)
30         imageView.frame = CGRect(x: 40, y: 80, width: 240, height: 360)
31         //将图像视图，添加到当前视图控制器的根视图
32         self.view.addSubview(imageView)
33     }
34     
35     //MARK:-
36     //MARK:didReceiveMemoryWarning
37     override func didReceiveMemoryWarning() {
38         super.didReceiveMemoryWarning()
39         // Dispose of any resources that can be recreated.
40     }
41 }

然后点击编辑器顶部导航条，弹出当前类的所有方法和函数列表。

然后在列表中，观察方法名称上方的注释文字。

当类文件中含有大量方法时，给类添加注释指令，可以对代码进行逻辑组织，并且提高工作效率。

点击某个方法，将快速定位到方法所在的位置。