<picture> <source media="(prefers-color-scheme: dark)" srcset="https://www.swift.org/assets/images/swift~dark.svg"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/028ae4a8-9d7c-46ed-adcf-d902f86d654c.svg" alt="Swift标志" height="70"> </picture>

Swift编程语言

	架构	构建
macOS	x86_64
Ubuntu 20.04	x86_64
Ubuntu 20.04	AArch64
Ubuntu 22.04	x86_64
Ubuntu 22.04	AArch64
CentOS 7	x86_64
Amazon Linux 2	x86_64
Amazon Linux 2	AArch64
Universal Base Image 9	x86_64
Debian 12	x86_64
Debian 12	AArch64
Fedora 39	x86_64
Fedora 39	AArch64
Windows 10	x86_64
Windows 10	ARM64

跨平台编译目标

目标	构建
wasm32-unknown-wasi

Swift社区托管的CI平台

操作系统	架构	构建
Android	ARMv7
Android	AArch64
Windows 2019 (VS 2019)	x86_64

欢迎使用Swift

Swift是一种高性能的系统编程语言。它拥有简洁现代的语法，可以无缝访问现有的C和Objective-C代码和框架，并且默认情况下是内存安全的。

虽然受到Objective-C和许多其他语言的启发，但Swift本身并不是一种C派生语言。作为一种完整独立的语言，Swift将核心功能如流程控制、数据结构和函数与高级构造如对象、协议、闭包和泛型打包在一起。Swift拥抱模块化，消除了头文件的需求及其带来的代码重复。

要了解更多关于该编程语言的信息，请访问swift.org。

• 为Swift做贡献
• 入门
  • Swift工具链
  • 构建失败
• 了解更多

为Swift做贡献

我们欢迎并鼓励为Swift做出贡献！请参阅为Swift做贡献指南。

在提交拉取请求之前，请确保您已经测试了您的更改，并且它们遵循Swift项目贡献代码指南。 要成为一个真正伟大的社区，Swift.org需要欢迎来自各行各业、背景各异、经验不同的开发者。一个多元化和友好的社区将会有更多伟大的想法、更多独特的视角，并产出更优秀的代码。我们将努力不懈地让Swift社区对每个人都保持欢迎态度。

为了明确我们对成员的期望，Swift采用了由Contributor Covenant定义的行为准则。这份文件在许多开源社区中被广泛使用，我们认为它很好地阐述了我们的价值观。更多详情，请参阅行为准则。

入门指南

如果你对以下内容感兴趣：

• 为编译器贡献修复和功能：请查看我们的如何提交你的第一个拉取请求指南。
• 一次性构建编译器：请查看我们的入门指南。
• 一次性构建工具链：按照入门指南直到"构建项目"部分。之后，请按照下面Swift工具链部分的说明进行操作。

我们还有一个FAQ回答常见问题。

Swift工具链

构建

Swift工具链使用build-toolchain脚本创建。swift.org的CI使用此脚本生成快照，它允许开发者在本地重现这些构建，用于开发或分发目的。一个典型的调用如下所示：

  $ ./swift/utils/build-toolchain $BUNDLE_PREFIX

其中$BUNDLE_PREFIX是一个字符串，将被添加到构建日期之前，用于生成工具链Info.plist的bundle标识符。例如，如果$BUNDLE_PREFIX是com.example，生成的工具链将有bundle标识符com.example.YYYYMMDD。它将在你运行脚本的目录中创建，文件名格式为：swift-LOCAL-YYYY-MM-DD-a-osx.tar.gz。

除了构建工具链，build-toolchain还支持以下（非详尽）有用选项：

• --dry-run：执行试运行构建。默认关闭。
• --test：在编译完成后测试工具链。默认关闭。
• --distcc：使用distcc通过分布式编译Swift构建的C++部分来加速构建。默认关闭。
• --sccache：使用sccache通过缓存更多C++构建产物来加速后续的编译器构建。默认关闭。

随着时间推移，可能会添加更多选项。请传递--help给build-toolchain以查看完整的选项集。

安装到Xcode

在macOS上，如果想将这样的工具链安装到Xcode中：

1. 解压并复制工具链到/Library/Developer/Toolchains/或~/Library/Developer/Toolchains/之一。例如：

  $ sudo tar -xzf swift-LOCAL-YYYY-MM-DD-a-osx.tar.gz -C /
  $ tar -xzf swift-LOCAL-YYYY-MM-DD-a-osx.tar.gz -C ~/

该脚本还会生成一个包含调试符号的归档文件，可以安装在主归档文件之上，允许对任何编译器崩溃进行符号化。

  $ sudo tar -xzf swift-LOCAL-YYYY-MM-DD-a-osx-symbols.tar.gz -C /
  $ tar -xzf swift-LOCAL-YYYY-MM-DD-a-osx-symbols.tar.gz -C ~/

2. 通过Xcode->Toolchains指定本地工具链供Xcode使用。

构建失败

尝试解决构建问题中的建议。

确保你使用的是正确版本的Xcode。

如果你已更改Xcode版本但仍遇到似乎与Xcode版本相关的错误，请尝试向build-script传递--clean参数。

当新版本的Xcode发布时，你可以通过向build-script传递--reconfigure参数来更新你的构建，而无需重新编译整个项目。

了解更多

请务必查看文档索引以获得可用文档的概览。特别是，在提交你的第一个PR之前，阅读标题为调试Swift编译器和Swift的持续集成的文档会非常有帮助。