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

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

---

一、安装 Swift（macOS 环境）

1. 通过 Xcode 安装（推荐）

1. 打开 App Store，搜索并安装 Xcode（苹果官方开发工具，包含 Swift 编译器）。
2. 安装完成后，打开终端（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）

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

   swift --version
   

---

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

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

1. 通过环境变量配置

1. 打开终端，输入以下命令（以 ~/swift_packages_cache 为例）：

   echo 'export SWIFTPM_CACHE_DIR="$HOME/swift_packages_cache"' >> ~/.zshrc  # 或 ~/.bash_profile
   source ~/.zshrc
   

2. 创建缓存目录并验证：

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

---

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

1. 创建文件 hello.swift，输入以下代码：

   swift">print("你好，世界！")
   

2. 运行程序：

   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。

---

五、总结

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

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

下一步建议：

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

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