开发环境搭建

环境搭不好，后面全白搭。这一章不折腾花哨配置，只帮你把能编译运行 Swift 代码的最小环境准备好。先确认版本：本教程基于 Swift 6.3.2，功能版 6.3 于 2026 年 3 月发布，补丁 6.3.2 于 2026 年 5 月推出。

1-1 先确认你要哪条路

Swift 能在 macOS、Linux、Windows 上跑，但体验不一样，搭法也不同。先对号入座：

macOS 用户最省心，装 Xcode 就自带完整工具链，还能用图形化 IDE 和 Playground，强烈推荐走这条路。

Linux 用户（常见 Ubuntu、Fedora 等）通过官方工具链使用，纯命令行，适合写服务端或学习。

Windows 用户有官方提供的工具链，但成熟度不如前两者，日常学习和小程序没问题。

不管哪条路，最终你都会有一个能用的 swift 命令。后面验证环境都靠它。

1-2 macOS：装 Xcode 最省事

在 Mac 上，最简单的办法是从 App Store 安装 Xcode。Xcode 是苹果官方的集成开发环境，装上之后 Swift 编译器、调试器、模拟器、Playground 全部齐活，而且版本和 Swift 6.3 工具链对应。

装完 Xcode，建议再打开一次，让它完成首次组件的初始化。之后在终端里输入下面命令，应该能看到版本号：

swift --version

如果显示的版本是 6.3.x，说明工具链就位了。你写的每一个 .swift 文件，都能用 Xcode 打开、运行、调试。

1-3 macOS 的另一种选择：命令行工具包

如果你不想装体积庞大的 Xcode，只是想在终端里编译 Swift，可以只装”命令行工具”。在终端执行：

xcode-select --install

系统会弹窗引导你安装。装好后同样拥有 swift 命令，适合轻量学习和写脚本。

1-4 Linux：用官方工具链

在 Linux 上，去 Swift 官网（swift.org）的下载页，选对应发行版和架构的 toolchain 包。下载后按官方说明解压，并把工具链的 usr/bin 加进环境变量 PATH。

以 tar 包为例，解压后把路径导出即可：

export PATH=/path/to/swift-6.3.2-RELEASE/usr/bin:$PATH
swift --version

看到 6.3.2 字样就成功了。不同发行版（apt、dnf 等）也有对应的安装方式，具体看官网文档，核心都是让 swift 命令能在终端直接调用。

1-5 Windows：官方工具链与 WSL

Windows 上可以从 Swift 官网下载 Installer 安装包，按向导装完，会提供一个 Swift 开发者命令提示符，在里面就能用 swift 命令。

另一条更稳的路是用 WSL（Windows 子系统 Linux），在里面对照 Linux 的方式装工具链。对想深度使用 Swift 的 Windows 用户，WSL 通常比原生 Windows 工具链更顺。

1-6 验证环境是否真的能用

装完别急着走，做个最小验证。新建一个文件叫 hello.swift，写一行：

print("Hello, Swift!")

然后在终端进入文件所在目录，运行：

swift hello.swift

如果能打印出 Hello, Swift!，恭喜，你的环境已经能编译运行 Swift 代码了。这一步很重要，后面每一章的例子，你都可以照着用 swift 文件名.swift 跑起来看结果。

1-7 编辑器怎么选

macOS 用 Xcode 是标配，但如果你更喜欢轻量编辑器，VS Code 装 Swift 插件也能获得不错的补全和调试体验。Linux 和 Windows 上，VS Code 加 Swift 插件是常见组合。

编辑器只是外壳，真正干活的是背后的 swift 编译器。选你顺手的就行，本教程所有例子都不依赖特定编辑器。

1-8 常见环境坑与排查

装环境最容易卡在版本对不上。请确认 swift --version 显示 6.3.x 而非旧版 5.x。部分 Linux 发行版仓库仍停留旧版，遇到就直接去官网下对应 toolchain，别将就。macOS 上 Xcode 装完 swift 仍找不到，多半是命令行工具未装或路径未刷新，跑 xcode-select --install 再重启终端通常解决。Windows 原生工具链若报错，优先试 WSL，社区稳定性反馈更好。

另一个常被忽略的点：本教程例子都是纯语言，不依赖任何苹果框架，所以你不必配模拟器、不必申请开发者账号。只要 swift 文件.swift 能打印结果，环境就够用。把精力放理解语法，别在环境上过度折腾。

网上 Swift 资料鱼龙混杂，部分基于很早的 Swift 2/3，语法与今天差异巨大。看到 var 满篇、或大量强制解包的老代码，基本是过时内容，别照抄。以 Swift 5 之后、尤其 6.x 资料为准。环境就绪只是第一步，真正门槛在坚持每天写一点，哪怕只跑通三个小程序，一个月后语感也会截然不同。

还有个实用建议：把验证命令 swift 文件名.swift 记熟，它能跑通任意顶层代码。将来写复杂例子卡住时，就拆成几行用这个命令逐段试，比闷头看强。环境是地基，稳了就别再回头纠结它。

1-9 补记：版本与排查习惯

顺带一提，环境这关过了之后，建议把 swift --version 的输出记一下，将来遇到行为差异时，能快速确认自己用的版本。Swift 迭代快，同样代码在不同版本可能有细微差别，版本信息是第一手排查线索。另外，终端里的历史命令（上下方向键）能帮你快速重跑刚才的命令，学 Swift 期间会反复用到，早点熟悉能省不少打字。

环境类问题九成是路径和版本，剩下的才是真 bug。养成”先确认版本、再怀疑代码”的习惯，能省下大量瞎折腾的时间。

1-10 小结

搭环境就三步：选对你的平台路线（macOS 装 Xcode 最省心，Linux/Windows 装官方工具链），确保 swift --version 显示 6.3.x，再用一个 print 小程序验证能跑通。环境就绪后，下一章我们就正式写出第一个程序。