Swift类扩展的文档注释

我正在扩展

UIColor

，并试图为扩展类提供支持

我的代码是

/**
 - To store all colors
 - Naming Convention identifier: In lowerCamelCase with single name description
 - Naming Convention value: single name

 - example:  self.view.backgroundColor = UIColor.View.NonCompliant

 */
extension UIColor{

        /**
         - To specify all seperators' color
         */
        struct Seperators{
            static let commonSeperator = UIColor(red: 53.0/255.0, green: 126.0/255.0, blue: 167.0/255.0, alpha: 1.0)
        }
}

但是Xcode仍然显示原始描述，而不是修改后的描述

---

有人知道怎么做吗？

您可以使用xcode的文档。选择方法名称和Xcode->编辑器->结构->添加文档。Xcode为您生成文档。

---

或者应该剪切alt+cmd+/

也许你可以看看这些：HeaderDoc&Doxygen，但它仍然只显示内部描述。很确定你不能记录注释扩展。他们匿名的一个后果。您只能记录扩展中的内容。@Josh CasWell Ohh好的。。我想可能有一种我不知道的方法。。不过还是要谢谢你……）问题是xcode只生成模板，在添加行时不添加额外的“//”。这意味着你必须自己照顾它，这很烦人。