Playground环境搭建

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

单行和多行注释

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

//: [Previous](@previous)

import Foundation

var str = "Hello, playground"

//: [Next](@next)

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

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

// 这是单号注释

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


/* 我是多行注释start
// 我是嵌套的单行注释
/*
我是嵌套的多行注释
我是嵌套的多行注释*/
我是多行注释end */

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

markup注释

支持markup语法，即markdown语法

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

/*:
# 一级标题

## 无序列表
- 第一项
- 第二项

## 有序列表
1. 第一项
2. 第二项

## 笔记
> This is a note
---

## 链接
[阳光沙滩](https://mp.sunofbeach.net)
*/


/**  **函数描述**
## 函数注释，开启markup,建议使用多行
- 支持单行注释
- 支持多行注释
- 支持嵌套注释
- 支持markdown语法
*/
func showComments(){	
}

showComments()

即：

单行注释 以 //: 开启

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

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

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

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