《The Swift Programming Language》in Chinese

中文版 Apple 官方 Swift 教程《The Swift Programming Language》

英文原版在线版

英文原版ePub版

在线阅读

使用 Gitbook 制作，可以直接在线阅读。

当前阶段

Swift 4.2 翻译中，请到 issue 中认领章节。

• 更新到 Swift 3.0。 2016-09-23

3.0 译者记录

相关issue

• Functions: crayygy
• Control Flow: Realank
• Closures: LanfordCai
• Protocols: chenmingbiao
• The Basics:chenmingbiao
• Advanced Operators: mmoaay

Language Reference:

• Attributes: WhoJave
• Statements: chenmingjia
• Declarations: chenmingjia
• Expressions: chenmingjia
• Types: lettleprince
• Generic Parameters and Arguments: chenmingjia

2.1 & 2.2 译者记录

详见各章节开头位置。

2.0 译者记录

• About Swift （xtymichael）
• A Swift Tour（xtymichael）
• The Basics（xtymichael）
• Basic Operators（AlanMelody）
• Strings and Characters（DianQK）
• Collection Types（AlanMelody）
• Control Flow（AlanMelody）
• Functions（dreamkidd）
• Closures（100mango）
• Enumerations（futantan）
• Classes and Structures（SkyJean）
• Properties（yangsiy）
• Methods（DianQK）
• Subscripts（shanksyang）
• Inheritance（shanksyang）
• Initialization（chenmingbiao）
• Deinitialization（chenmingbiao）
• Automatic Reference Counting（Channe）
• Optional Chaining（lyojo）
• Error Handling（lyojo）
• Type Casting（yangsiy）
• Nested Types（SergioChan）
• Extensions（shanksyang）
• Protocols（futantan）
• Generics（SergioChan）
• Access Control（mmoaay）
• Advanced Operators（buginux）
• About the Language Reference（KYawn）
• Lexical Structure（buginux）
• Types（EudeMorgen）
• Expressions（EudeMorgen）
• Statements（littledogboy）
• Declarations（Lenhoon）
• Attributes（KYawn）
• Patterns（ray16897188）
• Generic Parameters and Arguments（wardenNScaiyi）
• Summary of the Grammar（miaosiqi）

1.0 译者记录

• 欢迎使用 Swift
  • 关于 Swift (numbbbbb)
  • Swift 初见 (numbbbbb)
• Swift 教程
  • 基础部分 (numbbbbb, lyuka, JaySurplus)
  • 基本操作符 (xielingwang)
  • 字符串和字符 (wh1100717)
  • 集合类型 (zqp)
  • 控制流 (vclwei, coverxit, NicePiao)
  • 函数 (honghaoz)
  • 闭包 (wh1100717)
  • 枚举 (yankuangshi)
  • 类和结构体 (JaySurplus)
  • 属性 (shinyzhu)
  • 方法 (pp-prog)
  • 下标 (siemenliu)
  • 继承 (Hawstein)
  • 构造过程 (lifedim)
  • 析构过程 (bruce0505)
  • 自动引用计数 (TimothyYe)
  • 可选链 (Jasonbroker)
  • 类型检查 (xiehurricane)
  • 嵌套类型 (Lin-H)
  • 扩展 (lyuka)
  • 协议 (geek5nan)
  • 泛型 (takalard)
  • 高级操作符 (xielingwang)
• 语言参考
  • 关于语言参考 (dabing1022)
  • 词法结构 (superkam)
  • 类型 (lyuka)
  • 表达式 (sg552 )
  • 语句 (coverxit)
  • 声明 (marsprince)
  • 特性 (Hawstein)
  • 模式 (honghaoz)
  • 泛型参数 (fd5788)
  • 语法总结 (StanZhai)

贡献力量

如果想做出贡献的话，你可以：

• 帮忙校对，挑错别字、病句等等
• 提出修改建议
• 提出术语翻译建议

翻译术语参照表

翻译建议

如果你愿意一起校对的话，请仔细阅读：

• 相关术语请严格按照术语表来翻译，如果实在有问题可以发 Issues 大家一起讨论
• 使用markdown进行翻译，文件名必须使用英文，因为中文的话gitbook编译的时候会出问题
• 翻译后的文档请放到source文件夹下的对应章节中，然后pull request即可，我会用gitbook编译成网页
• 工作分支为gh-pages，用于GitHub的pages服务
• fork过去之后新建一个分支进行翻译，完成后pull request这个分支，没问题的话我会合并到gh-pages分支中
• 有其他任何问题都欢迎发issue，我看到了会尽快回复

谢谢！

关于术语

翻译术语的时候请参考这个对照表：

术语	备选翻译
associatedtype	关联类型
range	区间
type property	类型属性
Unary operator	一元运算符
Binary operator	二元运算符
Ternary operator	三元运算符
Labeled Statement	具名语句
conform Protocol	遵循协议
availability-condition	可用性条件
fallthrough	贯穿
Branch Statement	分支语句
Control Transfer Statement	控制传递语句
Type Annotation	类型标注
Type Identifier	类型标识符
Metatype Type	元类型
Protocol Composition Type	复合协议类型
associated value	关联值
raw value	原始值
computed property	计算属性
stored property	存储属性
operator	运算符
playground	不翻译
array	数组
dictionary	字典
list	列表
statement	语句
expression	表达式
optional	可选
Implicitly Unwrapped optional	隐式解包可选值
Optional Binding	可选绑定
optional chaining	可选链
collection	集合
convention	约定
iterate	迭代
nest	嵌套
Inheritance	继承
override	重写
base class	基类
Designated Initializer	指定构造器
Convenience Initializer	便利构造器
Automatic Reference Counting	自动引用计数
type inference	类型推断
Type Casting	类型转换
unwrapped	解包
wrapped	包装
note	注意
closure	闭包
tuple	元组
first-class	一等
deinitializer	析构器
Initializer	构造器
initialization	构造过程
deinitialization	析构过程
getter	不翻译
setter	不翻译
subscript	下标
property	属性
attribute	特性或者属性，根据上下文
method	方法
Enumeration	枚举
Structure	结构体
Protocol	协议
Extension	扩展
Generic	泛型
literal value	字面量
alias	别名
Assertion	断言

• 尽量保证和已翻译的内容一致
• 如果对术语参照表有疑问或者建议可以提 Issues 进行讨论
• 如果以上两条都没有找到合适的结果，请自己决定一个合适的翻译或者直接使用英文原文，后期校对的时候会进行统一

参考流程

有些朋友可能不太清楚如何帮忙翻译，我这里写一个简单的流程，大家可以参考一下：

1. 首先 fork 我的项目
2. 把 fork 过去的项目也就是你的项目 clone 到你的本地
3. 在命令行运行 git branch develop 来创建一个新分支
4. 运行 git checkout develop 来切换到新分支
5. 运行 git remote add upstream https://github.com/numbbbbb/the-swift-programming-language-in-chinese.git 把我的库添加为远端库
6. 运行 git remote update更新
7. 运行 git fetch upstream gh-pages 拉取我的库的更新到本地
8. 运行 git rebase upstream/gh-pages 将我的更新合并到你的分支

这是一个初始化流程，只需要做一遍就行，之后请一直在develop分支进行修改。

如果修改过程中我的库有了更新，请重复 6、7、8 步。

修改之后，首先 push 到你的库，然后登录 GitHub，在你的库的首页可以看到一个 pull request 按钮，点击它，填写一些说明信息，然后提交即可。

开源协议

基于WTFPL协议开源。