基本准则 用法一目了然是你设计时最重要的目的. 方法和属性这样的实体只声明一次,却会被重复调用.因此你在设计 API 时应尽可能使其简单明了.当评估某个设计时,只阅读声明往往是不够的,有时还需要检查它的使用样例,才能确保其在上下文中足够清晰. 一目了然比简洁更重要. 尽管 Swift 代码可以非常简明,但是使用少量的字符使得代码变得简短并不是我们的目的.简洁的 Swift 代码,会成为强类型系统副作用,而同时也是自然地降低版面的重要特点. 给每个声明编写文档注释.编写文档会对你的设计产生深远的影…