本文由星夜暮晨（简书）翻译自苹果 Swift 官方网站
原文 Swift 3 API Design Guidelines
2015年12月4日
一款编程语言标准库的设计理念，往往对这门编程语言给人的整体感觉有很大影响。好的标准库就好似语言本身的扩展一般，并且保证标准库内部的一致性可以有效提升整体的开发体验。为了搭建一个好的 Swift 标准库，Swift 3 的其中一个主要目标就是要定义一组 API 设计准则，并且始终如一地应用这些准则。
Swift API 设计准则包含了几个主要目标，它们都旨在统一 Swift 的开发风格。这些主要目标分别是：
Swift API 设计准则：实际的 API 设计准则我们目前正在积极开发中。目前，Swift API 设计准则的最新样稿已经可以查看了！
Swift 标准库：整个 Swift 标准库正在审查和更新，以便能够遵循 Swift API 设计准则。实际的工作正在 Swift 仓库中的 swift-3-api-guidelines 分支进行。
导入 Objective-C API：将 Objective-C API 翻译成 Swift 的工作正在进行，采用了几种启发式逻辑，这是为了让 Objective-C API 能够更好地匹配 Swift API 设计准则。Objective-C API 的 Swift 翻译指南这个提议描述了哪一种翻译方式是有效的。当然，由于这个过程采用了一系列的启发式逻辑方法，因此我们会跟踪其对 Cocoa 和 Cooca Touch 所造成的影响，包括使用这些框架的 Swift 代码的工作情况。Swift 3 API 设计指南审查仓库提供了一种如何查看这种自动翻译过程的方法，以便查看对使用 Cocoa 和 Cocoa Touch 的 Swift 代码的影响。将不会被翻译为 Swift 的某些特殊 Objective-C API 将会被标记出来（比如说使用 NS_SWIFT_NAME 宏），以提升最终所得的 Swift 代码的质量。虽然这种变化主要影响的是 Apple 平台，但是它也会对提供了和 Objective-C 框架相同的 API 的跨平台 Swift 核心库（比如说 Swift 中使用的 Objective-C 运行时）造成一定的直接影响。
Swift 设计准则检查：目前现有的 Swift 代码都遵循了不同的编码风格，甚至还包括了针对 Cocoa 的 Objective-C 代码指南。借助用来导入 Objective-C API 的启发式逻辑，Swift 编译器（可以）能够检查常见的 API 设计模式，找出不符合 Swift API 设计准则的 API，并提供建议。
Swift 2 迁移到 Swift 3：Swift 标准库和导入 Objective-C API 将会是 Swift 的一次重大更新，对源代码进行了一次全新的更正操作。因此，我们还需要创建一个能够将 Swift 2 代码迁移到 Swift 3 API 的迁移器。
所有这些主要工作都正在积极地开发当中。如果您对上述工作有兴趣，那么可以 check out Swift API design guidelines、Swift standard library changes、Objective-C API importer changes提议以及目前的review repository，然后加入swift-evolution mailing list上的讨论组中。
I 相关 / Other
“你相信吗？有朝一日，这间房子旁的一块大理石板上会写着：西格蒙德·弗洛伊德博士于1895年7月24日在
前段时间 iFixit 对 iPhone 6s 的拆解中发现了，存在三星和台积电两个不同版本的 A9 处理器。虽然苹果随后
好的设计往往会让人有一种醍醐灌顶的感觉：为什么以前没人这么做呢？ 最近让人有这个想法的，是加拿大服装
前言：我是绝不会理睬有绝对音高的人的！哼！目录：I. 视唱练耳的重要性II.视唱练耳的内容范围III. 简单有效
可以转载，转载请注明出处。我是投资人。不瞒你说，我投出去的钱大部分打了水漂。很少有成功并盈利的，很少