在这里，您将找到有关如何使用 Swift 编程语言的信息。

如果你不熟悉 Swift，请查看  A Swift Tour  in The Swift Programming Language ，快速了解 语言最重要的概念和功能。

安装 Swift

使用 Swift 的第一步是下载并安装 编译器和其他必需的组件。 转到下载页面 ，然后按照目标平台的说明进行操作。

为了遵循以下示例， 确保将 Swift 添加到您的 . $PATH

在 macOS 上

macOS 上可下载工具链的默认位置为 。 您可以使用以下命令从终端使用最新安装的工具链： /Library/Developer/Toolchains

$ export TOOLCHAINS=swift

要选择任何其他已安装的工具链，请在变量中使用其标识符。标识符可以在工具链的文件中找到。 TOOLCHAINSInfo.plist

$ /usr/libexec/PlistBuddy -c "Print CFBundleIdentifier:" /Library/Developer/Toolchains/swift-4.0-RELEASE.xctoolchain/Info.plist
org.swift.4020170919
$ export TOOLCHAINS=org.swift.4020170919

在 Linux 上

1. 安装所需的依赖项：

$ apt-get install \
          binutils \
          git \
          libc6-dev \
          libcurl4 \
          libedit2 \
          libgcc-5-dev \
          libpython2.7 \
          libsqlite3-0 \
          libstdc++-5-dev \
          libxml2 \
          pkg-config \
          tzdata \
          zlib1g-dev

$ apt-get install \
          binutils \
          git \
          gnupg2 \
          libc6-dev \
          libcurl4 \
          libedit2 \
          libgcc-9-dev \
          libpython2.7 \
          libsqlite3-0 \
          libstdc++-9-dev \
          libxml2 \
          libz3-dev \
          pkg-config \
          tzdata \
          uuid-dev \
          zlib1g-dev

$ apt-get install \
          binutils \
          git \
          gnupg2 \
          libc6-dev \
          libcurl4-openssl-dev \
          libedit2 \
          libgcc-9-dev >\
          libpython3.8 \
          libsqlite3-0 \
          libstdc++-9-dev \
          libxml2-dev \
          libz3-dev \
          pkg-config \
          tzdata \
          unzip \
          zlib1g-dev

$ yum install \
      binutils \
      gcc \
      git \
      glibc-static \
      libbsd-devel \
      libedit \
      libedit-devel \
      libicu-devel \
      libstdc++-static \
      pkg-config \
      python2 \
      sqlite
      # __block conflicts with clang's __block qualifier
      sed -i -e 's/\*__block/\*__libc_block/g'  /usr/include/unistd.h

$ yum install \
      binutils \
      gcc \
      git \
      glibc-static \
      gzip \
      libbsd \
      libcurl \
      libedit \
      libicu \
      libsqlite \
      libstdc++-static \
      libuuid \
      libxml2 \
      tar \
      tzdata

如果你在 Linux 上安装了 Swift 工具链 到系统根目录以外的目录， 您将需要运行以下命令， 使用 Swift 安装的实际路径：

$ export PATH=/path/to/Swift/usr/bin:"${PATH}"

在视窗上

依赖

Swift 有以下一般依赖关系：

• Git（由 Swift Package Manager 使用）

• Python¹（由调试器 - lldb 使用）

Windows 具有以下特定于平台的附加依赖项：

• Windows SDK（提供 Windows 标头和导入库）

• Visual Studio（为其他标头提供Visual C++ SDK/Build Tools）

启用开发人员模式

为了开发应用程序，特别是使用 Swift 包管理器，您需要启用开发人员模式。有关启用开发人员模式的说明，请参阅 Microsoft 的文档。

安装说明

使用 Windows 程序包管理器安装

Windows 程序包管理器可以在 App Store 中找到或直接安装。

使用勺子安装

# Optional: Needed to run a remote script the first time
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
# Command for installing scoop
Invoke-RestMethod -Url 'get.scoop.sh' | Invoke-Expression

1. 安装所需的依赖项：

   无法通过当前支持的包管理器安装平台依赖项，因为安装规则不会安装必要的组件。它们将通过Visual Studio安装程序安装。

   使用 Winget （Windows Package Manager）：

   winget install Git.Git
   winget install Python.Python.3.10
   
   curl -sOL https://aka.ms/vs/16/release/vs_community.exe
   start /w vs_community.exe --passive --wait --norestart --nocache ^
     --installPath "%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Community" ^
     --add Microsoft.VisualStudio.Component.Windows10SDK.19041 ^
     --add Microsoft.VisualStudio.Component.VC.Tools.x86.x64
   del /q vs_community.exe
   

   带勺子：

   # Scoop already comes pre-installed with Git, so no need to re-install it.
   scoop bucket add versions
   scoop install python310
   
   curl -sOL https://aka.ms/vs/16/release/vs_community.exe
   start /w vs_community.exe --passive --wait --norestart --nocache ^
     --installPath "%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Community" ^
     --add Microsoft.VisualStudio.Component.Windows10SDK.19041 ^
     --add Microsoft.VisualStudio.Component.VC.Tools.x86.x64
   del /q vs_community.exe
   

   启动一个新的命令提示符/Powershell 提示符并安装 Python 库 6。

   pip install six
   

2. 安装 Swift：

   Swift可以直接通过官方安装程序安装，也可以使用Windows包管理器安装。请注意，Windows 程序包管理器版本可能落后于正式版本。

   • 使用官方安装程序：
     1. 下载:最新的软件包版本。
     2. 运行包安装程序。
   • 使用 Windows 程序包管理器：

     winget install Swift.Toolchain
     

   • 使用勺子：

     scoop install swift
     

Swift 工具链将安装在 。兼容的 Swift SDK 将安装在 。 %SystemDrive%\Library\Developer\Toolchains\unknown-Asserts-development.xctoolchain
%SystemDrive%\Library\Developer\Platforms\Windows.platform\Developer\SDKs\Windows.sdk

传统安装

注意：低于 5.4.2 的 Swift 需要传统的安装过程。

Swift 已经在 Visual Studio 2019 中进行了测试。您需要使用以下组件安装 Visual Studio。Swift 的安装程序可在下载部分找到。Windows 上的工具链将安装到 。 %SystemDrive%\Library\Developer\Toolchains

需要以下 Visual Studio 组件：

建议使用以下其他 Visual Studio 组件：

建议使用以下附加的 Visual Studio 组件：

支持文件

注意：仅 5.4.2 之前的版本才需要执行此操作

必须使用 才能运行以下步骤。从Visual Studio运行脚本，该脚本设置必要的环境变量以查找系统标头。
x64 Native Tools for VS2019 Command Prompt
x64 Native Tools for VS2019 Command Prompt
DevEnv

为了使 Windows SDK 可供 Swift 访问，有必要将一些文件部署到 Windows SDK 中。以下内容将修改您的 Visual Studio 安装，因此需要从（提升的）“管理员”运行。 x86 Native Tools for VS2019 Command Prompt

copy /Y %SDKROOT%\usr\share\ucrt.modulemap "%UniversalCRTSdkDir%\Include\%UCRTVersion%\ucrt\module.modulemap"
copy /Y %SDKROOT%\usr\share\visualc.modulemap "%VCToolsInstallDir%\include\module.modulemap"
copy /Y %SDKROOT%\usr\share\visualc.apinotes "%VCToolsInstallDir%\include\visualc.apinotes"
copy /Y %SDKROOT%\usr\share\winsdk.modulemap "%UniversalCRTSdkDir%\Include\%UCRTVersion%\um\module.modulemap"

因为它正在将文件安装到 Visual Studio 映像中，所以每次更新 Visual Studio 时都需要复制这些文件。

Visual Studio 更新后修复

如果 Visual Studio 已更新，您可能需要修复安装。请参阅Microsoft有关修复已安装程序的说明。

迅捷版

您可以验证您运行的是预期的 Swift 版本 通过输入命令并传递标志：swift--version

$ swift --version
Apple Swift version 2.2-dev (LLVM ..., Clang ..., Swift ...)

版本号上的后缀 用于指示它是一个开发版本， 不是已发布的版本。-dev