最稳妥的方式是用 Xcode 安装 Swift 工具链，它自带编译器、调试器、标准库和命令行工具，适配当前 macOS 版本，也兼容 Playgrounds 和 Swift Package Manager。最稳妥的方式是用 Xcode 安装 Swift 工具链，它自带编译器、调试器、标准库和命令行工具，适配当前 macOS 版本，也兼容 Playgrounds 和 Swift Package Manager。
用 Xcode 安装（推荐首选）
xcode 是苹果官方维护的完整开发环境，swift 编译器（swiftc）、构建工具（swift build）、包管理器（swift package）和 playground 都已集成其中。
- 打开 App Store，搜索并安装 Xcode（当前稳定版约 12–14 GB，需 macOS Monterey 12.3 或更高版本）
- 首次启动 Xcode，同意许可协议，系统会自动下载并安装额外组件（如模拟器、文档、命令行工具）
- 终端执行
xcode-select --install可补装命令行工具（若未自动安装） - 验证路径是否生效：
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer - 运行
swift --version确认输出版本（如 Apple Swift version 5.9），表示工具链就绪
仅需命令行 Swift（轻量替代）
如果不需要 IDE、模拟器或 Interface Builder，只想在终端写 Swift 脚本或构建 CLI 工具，可跳过 Xcode，直接安装独立 Swift 工具链。
- 访问 swift.org/download，下载对应 macOS 的 .pkg 安装包（如
swift-5.9-RELEASE-osx.pkg） - 双击安装，它会把
swift、swiftc等二进制文件放入/usr/bin/ - 安装后仍需运行
xcode-select --install补全 clang、libicu 等底层依赖 - 注意：该方式不提供 Playground、iOS 模拟器或 Xcode 项目模板
Homebrew 不是 Swift 的安装渠道
Homebrew 本身不托管官方 Swift 编译器。虽然可通过 brew install swift 安装某些社区维护的 Swift 版本，但这些非苹果签名、不保证 ABI 兼容性，也不随系统更新同步。建议避免用于生产或学习环境。
- Homebrew 更适合安装辅助工具：比如
brew install swiftlint（代码风格检查）、swiftenv（多版本管理） - 若要用 swiftenv 切换 Swift 版本，仍需先通过 Xcode 或官网 pkg 安装至少一个基础版本
日常维护要点
Swift 工具链不是“一劳永逸”，需配合系统与 Xcode 升级保持一致性。
- Xcode 升级后，务必重新运行
xcode-select --install或手动确认路径：xcode-select -p - 每次 macOS 大版本升级（如 Sonoma → Sequoia），需重装 Xcode 或更新其命令行工具
- 终端中若出现
error: unable to load standard library，通常是路径错乱，执行sudo xcode-select -r重置即可 - Playground 报错“Module not found”时，优先检查 Xcode 是否完成首次初始化（即是否弹出过许可协议窗口）
