Playground环境搭建
image.png

可以新建多个页面（New Playground Page），一个页面就是一个playground。

单行和多行注释
当我们新建一个Playground 的时候，Xcode 默认为我们生成了如下代码：

//: Previous

import Foundation

var str = “Hello, playground”

//: Next

其中，第一行即是注释。当 Swift 编译器在编译代码的时候会忽略掉你的注释。

Swift 中的注释和 C 的注释以及Java的注释基本相同。如下：

// 这是单号注释

/*
这是多行注释
这是多行注释
/

/ 我是多行注释start
// 我是嵌套的单行注释
/
我是嵌套的多行注释
我是嵌套的多行注释/
我是多行注释end /
注意，和其他语言不同的是，Swift的注释，支持多行注释中嵌套注释。

markup注释
支持markup语法，即markdown语法

//: ## 单行注释开启markup注释

/*:

一级标题

无序列表

  • 第一项
  • 第二项

有序列表

  1. 第一项
  2. 第二项

笔记

This is a note

链接

阳光沙滩
*/

/ 函数描述**

函数注释，开启markup,建议使用多行

  • 支持单行注释
  • 支持多行注释
  • 支持嵌套注释
  • 支持markdown语法
    */
    func showComments(){
    }

showComments()
即：

单行注释 以 //: 开启

多行注释以 /*: 开启，而且要换一行开始写注释

函数注释以多行/** 开启

如果要查看Markup 的注释效果，可以使用菜单，“Editor-> Show Rendered Markup” 看到效果，如下：

image.png

如果要查看函数的markdown注释效果，可以在光标选择函数名，按住command键，显示函数的帮助信息如下：

image.png