初学者也能看懂的 Swift 安装与配置教程

本教程将手把手教你如何在 macOS 系统上安装 Swift，配置依赖包缓存位置，并指出新手容易踩坑的细节。即使你是零基础小白，也能快速上手！

一、安装 Swift（macOS 环境）

1. 通过 Xcode 安装（推荐）

打开 App Store，搜索并安装 Xcode（苹果官方开发工具，包含 Swift 编译器）。安装完成后，打开终端（Terminal），输入以下命令验证：xcode-select --install # 确保安装命令行工具

swift --version

# 输出示例：Apple Swift version 5.9 (swiftlang-5.9.0.128.108 clang-1500.0.40.1)

2. 独立安装 Swift 工具链（不安装 Xcode）

访问 Swift 官网下载页面：https://www.swift.org/download/下载 Swift for macOS 的 .pkg 安装包（如 swift-5.9-RELEASE-osx.pkg）。双击安装包，按提示完成安装。验证安装：swift --version

二、配置 Swift Package Manager (SPM) 缓存位置

默认情况下，SPM 会将下载的依赖包缓存到 ~/Library/Caches/org.swift.swiftpm。若需自定义缓存路径：

1. 通过环境变量配置

打开终端，输入以下命令（以 ~/swift_packages_cache 为例）：echo 'export SWIFTPM_CACHE_DIR="$HOME/swift_packages_cache"' >> ~/.zshrc # 或 ~/.bash_profile

source ~/.zshrc

创建缓存目录并验证：mkdir -p ~/swift_packages_cache

swift package resolve # 任意项目运行此命令后，检查缓存目录是否有内容

三、编写并运行第一个 Swift 程序

创建文件 hello.swift，输入以下代码：print("你好，世界！")

运行程序：swift hello.swift

# 输出：你好，世界！

四、常见问题与易忽略点

1. 未安装命令行工具

现象：运行 swift 命令提示 command not found。解决：在终端输入 xcode-select --install，安装 Xcode 命令行工具。

2. 缓存路径权限不足

现象：SPM 提示无法写入缓存目录。解决：确保自定义缓存目录的权限：chmod 755 ~/swift_packages_cache

3. Xcode 版本与 Swift 版本冲突

现象：swift --version 显示的版本与项目要求不匹配。解决：

更新 Xcode 至最新版本。或通过 Swift 官网下载指定版本的 Swift 工具链。

4. 未同意 Xcode 许可协议

现象：首次使用 swift 或 git 命令时报错。解决：在终端运行 sudo xcodebuild -license，阅读并输入 agree。

五、总结

通过本教程，你已成功完成以下操作：

安装 Swift 并验证环境。配置 SPM 依赖包缓存位置（避免占用系统盘空间）。编写并运行第一个 Swift 程序。

下一步建议：

学习 Swift 基础语法（推荐 Swift 官方文档)。尝试使用 Xcode 创建 iOS/macOS 项目。

遇到问题欢迎留言讨论，祝你早日成为 Swift 高手！ 🚀