Xcode 的单/多行注释及注释文档，常用标记（swift）

1.单行，多行注释

• 快捷键：cmd + /
• 多行注释在选中多行基础上再按该快捷键

---

2.注释文档

意义： 一般用于函数的描述及其参数及返回值的说明 。

• 快捷键：cmd + opt + /
• 使用位置：函数上方

 /// <#Description#>//该网络请求函数的说明
    ///
    /// - Parameters://参数
    ///   - URLStr: <#URLStr description#>//URLStr 的说明
    ///   - paraDic: <#paraDic description#>//paraDic的说明
    ///   - success: <#success description#>//成功闭包回调说明
    ///   - failure: <#failure description#>//失败闭包回调说明
    class func POST(_ URLStr: String, paraDic: [String:String]?, success: ((Dictionary<String, Any>?) -> Void)?, failure:((Error?) ->Void)?)
    {

• 在别处使用该函数想查看注释文档，光标移动至该函数，按住opt键，出现?时单击，就会显示注释文档。
  <