README

《The Swift Programming Language》in Chinese

最新的 Swift 6 版本的文档已发布,可前往 doc.swiftgg.team 查看

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

英文原版在线版

在线阅读

使用 GitBook 制作,可以在 GitBook 网站阅读。

当前阶段

  • 更新到 Swift 6,2024-12-02,迁移到 doc.swiftgg.team

  • 更新到 Swift 5.7,2022-06-06

  • 更新到 Swift 5.6,2022-03-14

  • 更新到 Swift 5.5,2021-06-07

  • 更新到 Swift 5.4,2021-04-26

  • 更新到 Swift 5.3,2020-09-16

  • 更新到 Swift 5.2,2020-02-15

  • 更新到 Swift 5.1,2019-11-11

  • 更新到 Swift 5.0,2019-04-05

  • 更新到 Swift 4.5,2019-03-16

  • 更新到 Swift 4.2,2019-01-29

  • 更新到 Swift 4.1,2018-04-12,感谢 @Mylittleswift

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

贡献力量

如果想做出贡献的话,你可以:

  • 参与翻译

  • 帮忙校对,挑错别字、病句等等

  • 提出修改建议

  • 提出术语翻译建议

翻译建议

如果你有兴趣参与项目,请仔细阅读说明:

排版格式和流程说明:

原版文档差异比较:

在翻译时可以通过 Calibre 软件对 document 目录下 不同版本的文档进行 diff,检查待更新部分。

diff 操作如下:

将最新文档加入到 Calibre 中,点击 Edit Book,然后在编辑界面选择 File -> Compare to other book 检查各模块的更新内容,详见 链接

其他说明:

  • 相关术语请严格按照术语表来翻译,如果有问题可以发 Issue 大家一起讨论

  • 使用 Markdown 进行翻译,文件名必须使用英文

  • 翻译后的文档请放到 source 文件夹下的对应章节中,然后 Pull Request 即可,我们会用 GitBook 编译成网页

  • 有其他任何问题都欢迎发 Issue

术语表

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

术语
备选翻译

result builder

结果构造器

property wrapper

projected value

被呈现值

wrapped value

被包装值

argument

实参

parameter

形参

variadic parameters

可变参数

associated type

关联类型

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

断言

conditional compilation

条件编译

opaque type

不透明类型

function

函数

runtime

运行时

贡献者

贡献者列表,感谢大家!

协议

苹果官方文档 协议一致:Creative Commons Attribution 4.0 International (CC BY 4.0) License

最后更新于