初学者也能看懂的 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 高手！ 🚀
