The Swift Programming Language (Simplified Chinese Version by SwiftGG)

🚀 MiniMax Token Plan 惊喜上线！新增语音、音乐、视频和图片生成权益。邀请好友享双重好礼，助力开发体验！ 好友立享 8.8折 专属优惠 + Builder 权益，你赢返利 + 社区特权！ 👉 立即参与

---

English Version | 中文版本

English Version

This repository contains the source for The Swift Programming Language (sometimes abbreviated as TSPL), which is published on [docs.swift.org][published] and built using [Swift-DocC][docc].

This repository includes the latest version of TSPL, as well as Simplified Chinese translations corresponding to different Swift versions.

Building

Clone this repository and run docc preview swift-6.docc in this repository's root directory.

After running DocC, open the link that docc outputs to display a local preview in your browser.

Current Status

• Latest English version of The Swift Programming Language. [Latest commit: 11a2b29][11a2b29]
• Corresponding Simplified Chinese translations (in progress and archived):

- Swift 6 beta (currently in translation) - Swift 5.x and earlier versions (available for reading on [GitBook][legacy-documentations])

How to Contribute

• Fork this repository to your account. Claim a translation task labeled as Swift x translation in the issues. Create a branch in your forked repository corresponding to the issue, setting the source branch to the current Swift version being translated (e.g., swift-6-beta-translation).

• Install the docc command-line tool by either downloading the toolchain from Swift.org or installing Xcode.

Note:

>

If you installed DocC by downloading a toolchain from Swift.org,

docc is located in usr/bin/,

relative to the installation path of the toolchain.

Make sure your shell's PATH environment variable

includes that directory.

>

If you installed DocC by downloading Xcode,

run xcrun docc preview swift-6.docc instead.

• Replace the content of the original Markdown file with your Chinese translation, following the terminology table below and the [SwiftGG style guide][swiftgg-style-guide]. Submit your translation through a Pull Request. Once verified by SwiftGG members, it will be merged into the current translation branch.

Contributors

We extend our heartfelt thanks to all our contributors. You can find the [list of contributors here][contributors].

中文版本

本仓库包含 The Swift Programming Language (缩写为 TSPL) 的源代码， 该文档发布在 [docs.swift.org][published] 上， 并使用 [Swift-DocC][docc] 构建。

本仓库包括 TSPL 的最新版本，以及对应不同 Swift 版本的简体中文翻译。

构建

克隆此仓库并在仓库根目录运行 docc preview swift-6.docc。

运行 DocC 后，打开 docc 输出的链接，即可在浏览器中显示本地预览。

当前状态

• The Swift Programming Language 的最新英文版本。[最新提交: 378f76a][https://github.com/swiftlang/swift-book/commit/378f76a4a0fb29cd72722686f78cb7c097437796]
• 对应的简体中文翻译 (进行中和已归档)：

- Swift 6 beta (当前正在翻译) - Swift 5.x 及更早版本 (可在 [GitBook][legacy-documentations] 上阅读)

如何贡献

• 首先，将此仓库 fork 到您的账户。在 issues 中认领标记为 Swift x translation 的翻译任务。在您 fork 的仓库中创建与 issue 对应的分支，将源分支设置为当前正在翻译的 Swift 版本 (例如，swift-6-beta-translation)。

• 通过从 Swift.org 下载 toolchain 或安装 Xcode 来安装 docc 命令行工具。

注意：

>

如果您通过从 Swift.org 下载 toolchain 安装了 DocC，

docc 位于 toolchain 安装路径下的 usr/bin/ 目录中。

确保您的 shell 的 PATH 环境变量包含该目录。

>

如果您通过下载 Xcode 安装了 DocC，

请运行 xcrun docc preview swift-6.docc。

• 按照下面的术语表和 [SwiftGG 排版指南][swiftgg-style-guide] 将原始 Markdown 文件的内容替换为您的中文翻译。通过 Pull Request 提交您的翻译。经 SwiftGG 成员验证后，将合并到当前的翻译分支。

参与成员

我们衷心感谢所有的参与成员。您可以在[这里][contributors]找到参与成员列表。

Terminology Table（术语表）

| Term | Suggest Transition | | --- | --- | | alias | 别名 | | array | 数组 | | argument | 实参 | | assertion | 断言 | | associated type | 关联类型 | | associated value | 关联值 | | attribute | 特性或者属性，根据上下文 | | automatic reference counting | 自动引用计数 | | availability-condition | 可用性条件 | | base class | 基类 | | binary operator | 二元运算符 | | boxed protocol type | 封装协议类型 | | branch statement | 分支语句 | | Class Hierarchy | 类层次结构 | | closure | 闭包 | | collection | 集合 | | computed property | 计算属性 | | conditional compilation | 条件编译 | | conform protocol | 遵循协议 | | control transfer statement | 控制传递语句 | | convenience initializer | 便利构造器 | | convention | 约定 | | decompose | 分解 | | deinitialization | 析构过程 | | deinitializer | 析构器 | | designated initializer | 指定构造器 | | dictionary | 字典 | | downcast | 向下转型 | | enumeration | 枚举 | | expression | 表达式 | | extension | 扩展 | | fallback (value) | 后备值 ?? 回退值 | | fallthrough | 贯穿 | | first-class | 一等 | | function | 函数 | | generic | 泛型 | | getter | 不翻译 | | implicitly unwrapped optional | 隐式解包可选值 | | inheritance | 继承 | | initialization | 构造过程 | | initializer | 构造器 | | iterate | 迭代 | | labeled statement | 具名语句 | | list | 列表 | | literal (value) | 字面量 | | metatype type | 元类型 | | method | 方法 | | nest | 嵌套 | | nil-coalescing | 不译 | | note | 注意 | | opaque type | 不透明类型 | | operator | 运算符 | | optional | 可选 | | optional binding | 可选绑定 | | optional chaining | 可选链 | | override | 重写 | | parameter | 形参 | | playground | 不翻译 | | projected value | 被呈现值 | | property | 属性 | | property wrapper | 属性包装器 | | protocol | 协议 | | protocol composition type | 复合协议类型 | | result builder | 结果构造器 | | range | 区间 | | raw value | 原始值 | | runtime | 运行时 | | scope | 作用域 | | setter | 不翻译 | | statement | 语句 | | stored property | 存储属性 | | string interpolation | 字符串插值 | | structure | 结构体 | | subscript | 下标 | | ternary operator | 三元运算符 | | tuple | 元组 | | type alias | 类型别名 | | type annotation | 类型注解 | | type identifier | 类型标识符 | | type property | 类型属性 | | type inference | 类型推断 | | type casting | 类型转换 | | unary operator | 一元运算符 | | unwrapped | 解包 | | variadic parameters| 可变参数 | | wrapped | 包装 | | wrapped value | 被包装值 | | superclass | 父类 | | subclass | 子类 |

[published]: https://docs.swift.org/swift-book/documentation/the-swift-programming-language/ [docc]: https://github.com/apple/swift-docc [11a2b29]: https://github.com/swiftlang/swift-book/commit/11a2b29983e9401c179d6269c9becc1256b11bc6 [legacy-documentations]: https://swiftgg.gitbook.io/swift/ [swiftgg-style-guide]: https://github.com/SwiftGGTeam/translation/blob/master/SwiftGG%20排版指南.md [contributors]: https://github.com/SwiftGGTeam/the-swift-programming-language-in-chinese/blob/gh-pages/source/contributors.md