代码片段

Xcode功能里我真的非常喜欢而且发现非常有用的一个（这一功能也组成了这个教程里我最喜爱的部分），就是有可能几乎不花时间的创建和重用代码段。使用这个功能可以节约大量的时间，因为可以显著避免在并不重要的任务上消耗太多精力。回想一下，举个例子，有多少次你已经写下了最基本的必要的tableview delegate和datasource 方法，感觉自己在浪费不必要的时间来试图记住这些方法的语法和定义。还有，你已经花费了多少时间在网上搜索怎样获取APP文件目录的方法，每次都需要在工程中使用那个路径。这些任务都是普遍要用到的，而且他们有标准的编写技术。因此，为什么不在Xcode里保存和管理一些可重用的代码，随时随地当需要的时候就使用它们，

Xcode默认保存了许多预先定义好的可以在工程里使用的代码片段。你所要做的，就是当你在一个源文件里时，打开Utilities面板，然后展示 Code Snippets库。

在上面的列表里可以找到一串非常棒的标准片段，比如类定义， if-else语句，循环 等等许多。说老实话，你将要使用的代码片段数量跟已经在类里存在的代码数量比比要少很多。并不是所有的代码段都是Swift或者Objective-C。你也可以找到用C 和C++写的代码段。只需记住一件事，就是使用每个代码段时它需要的合适的上下文环境。例如，一个类定义代码段不能被加到一个方法的body里，或着一个for 循环不能被直接加到一个类的method 方法外的body里。这个必须牢记，当然若你没有记得，compiler也会提醒你的。

为了在代码里使用一个预定义好的代码段，你只需要把它拖到文本编辑器上，就如下图展示那样：

马上，代码段就出现在你放置的位置那里并且等待你补齐缺失的部分：

有趣的部分是当你创建自己的代码段时。我们来通过一个例子来看怎样实现它，这个例子就是创建一个代码段来获取文件路径。在ViewController.swift 文件里，创建一个下面展示的新方法：

1 2	func fakeMethod() { }

在上面的方法里加入下面的一行代码来达到目的：

1 2 3

func fakeMethod() {      let documentsDirectoryPath = NSSearchPathForDirectoriesInDomains(.DocumentDirectory, .UserDomainMask, true)[0] as NSString }

现在，选中那条语句（只是那条语句，不是整个方法），点击它然后把它拖到snippets库里。如下图展示的一个弹出框就会出现：

注意：以防弹出窗口没有自动展示，你可以在library里搜索My Code Snippet 代码片段，然后双击它。

在这里你可以指定一些细节，而这也是它能做的所有。让我们来看看这些细节。首先，在窗口的底部你会看到代码本身，如果你想的话也可以在这里做一些改变。在上面的区域里你可以指定下面的内容：

1.Title:这里你可以给代码段设置一个合适的标题。在这个例子里，我们命名它为Documents Directory.

2.Summary: 这里是这个代码的简要描述信息。我们设置它的值为指定了到documents directory的路径。

3.Platform: 选择合适的platform，iOS或者MacOS。当然，如果你保留默认的值也没什么关系。

4.Language: 在这个菜单里你设置代码段的语言。默认情况下，当前使用的语言是被选中的。、

5.Completion Shortcut: 这是个非常有用的功能，因为你可以指定一个特定的关键值，每次你在编辑器里输入这个值，它就会被代码段给替换。这里我们设置关键值为mydocdir。

6.Completion Scopes: 在这里你实际上定义了代码段的适用范围，代表它是否应该在一个类里，方法里等被替换。如果点击这个区域你可以看到所有可能的选项，而这里默认的值是合适的（Function or Method）。使用加号和减号按钮，你可以添加或者删除适用范围。

下面的图片展示了关于新代码片段的上面所有的选项：

当你完成了，点击Done按钮。这个代码段就保存在了library里了，在它上面有一个写着User的标示，意味着它是一个自定义的代码段。

如果你双击它，弹出窗口又会展示出来。点击Edit按钮你可以随时修改上面的设置信息。

现在到fakeMethod() 方法然后删除掉它里面的内容。接下来，把自定义的代码段拖进这个方法里。代码就在那里了！是不是很酷？还有更好的。把代码再删掉，然后输入mydocdir关键值，正如下面展示那样：

只要Xcode自动匹配并且推荐给你，点击Return 值。这个关键值马上被代码段里自定义的代码替换了。太棒了！想想用了这个你可以节约多少时间！你所需要的仅仅是为最普遍的任务创建一般的代码段，然后你将永远不用再敲入任何代码了。

下面的将会给你展示自定义代码段在这两种方式下使用的动画：

在进入下一节之前，我们再创建一个代码段；这个代码段是我最欣赏的，因为它真的让我省去了许多不断写tableview相关方法时的麻烦。如果你想要，你可以删除掉 fakeMethod() 方法，然后在ViewController类里添加下面的方法定义：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

func numberOfSectionsInTableView(tableView: UITableView) -> Int {      return 1 }  func tableView(tableView: UITableView, numberOfRowsInSection section: Int) -> Int {      return 0 }  func tableView(tableView: UITableView, cellForRowAtIndexPath indexPath: NSIndexPath) -> UITableViewCell {      var cell = UITableViewCell()      return cell }  func tableView(tableView: UITableView, heightForRowAtIndexPath indexPath: NSIndexPath) -> CGFloat {      return 0.0 }  func tableView(tableView: UITableView, didSelectRowAtIndexPath indexPath: NSIndexPath) { }

接下来，选择它们所有，然后把它们拖到代码段library里。在弹出框里，设置下面的选项：

这里的关键值（为快捷方式）设置为mytableview。

在编辑器里删除上面所有代码，然后只输入关键值。方法又马上回来了！是不是太酷了？

当然，你可以在上面的集合中添加更多的方法，或者分开它们一个个成为独立的代码段。当然，可随意更改关键值也就是快捷键的名字。现在你知道这个方法了，赶快从中受益吧！