iOS_2026_National_Day/guides/environment.md

开发环境配置

适用于 2026 iOS 部国庆考核。最后核对：2026-10-01。软件版本更新很快，遇到与本文不一致的界面或报错，保留截图在 QQ 群求助。

先看结论：我需要装什么？

第一题只需要能运行 Swift 命令行程序，不需要 Mac，也不需要 Xcode；第三题要做 iOS App，才需要 Xcode（Mac）或 Swift Playground（iPad）。

我的设备	第一题（命令行 Swift）	第三题（SwiftUI App，选做）
Windows 电脑	Swift 工具链 + VS Code（见下文 Windows 部分）	无法开发 iOS App；可用 iPad 或借用 Mac
Mac，Apple 芯片（M 系列），系统 macOS Tahoe 26.6 及以上	Command Line Tools 或 Xcode 27 + VS Code / 终端	Xcode 27
Mac，Intel 芯片或系统较旧	Command Line Tools（能装上即可）	按下表选择与系统匹配的旧版 Xcode
iPad（iPadOS 18 及以上）	Swift Playground，在控制台查看输出	Swift Playground 可以写 SwiftUI App
Linux	官方 Swift 工具链（swiftly）+ VS Code	无法开发 iOS App

第一题只用到数组、循环、判断、函数和 print，都属于 Swift 标准库，在 Windows、macOS、Linux 上结果一致。本文示例程序已在 Swift 6.4（Linux）实际运行通过。

通用：安装 VS Code 与 Swift 扩展

Windows、Mac、Linux 都可以用 VS Code 写代码：

1. 从 code.visualstudio.com 下载安装 VS Code。
2. 先按下文装好对应系统的 Swift 工具链。
3. 打开 VS Code，左侧点“扩展”，搜索 Swift，安装发布者为 swiftlang 的官方扩展（ID：swiftlang.swift-vscode）。
4. 新建一个文件夹，在 VS Code 中“打开文件夹”，新建 main.swift。文件夹放在纯英文、无空格的路径下，例如 Windows 的 C:\swift\hello、Mac 的 ~/swift/hello。
5. 用菜单“终端 → 新建终端”，在下方终端里编译运行（命令见各系统部分）。

扩展主要为带 Package.swift 的项目提供完整功能；对单个 main.swift，它负责语法高亮和基础提示，编译运行一律在终端里完成，不用点 VS Code 的“运行”按钮。第一题要求文件名为 main.swift；文件夹里只放这一个 .swift 文件，一起编译多个文件时会报 expressions are not allowed at the top level。第一题禁止使用 AI 写代码或排错：如果 VS Code 装了 Copilot 等 AI 插件，做第一题时请关闭。

Windows：Swift 工具链 + VS Code（首选）

按 Swift 官方 Windows 安装说明（当前为 Swift 6.4）：

1. 以管理员身份打开“终端”或 PowerShell。

2. 安装依赖（Visual Studio 2022 的 C++ 组件和 Windows SDK，体积较大，需要一些时间）：

   winget install --id Microsoft.VisualStudio.2022.Community --exact --force --custom "--add Microsoft.VisualStudio.Component.Windows11SDK.22621 --add Microsoft.VisualStudio.Component.VC.Tools.x86.x64 --add Microsoft.VisualStudio.Component.VC.Tools.ARM64" --source winget
   

3. 安装 Swift 工具链：

   winget install --id Swift.Toolchain -e --source winget
   

4. 关闭并重新打开终端（必要时重启电脑），运行 swift --version，看到版本号即安装成功。

   • 不想用 winget 时，也可以从 Swift 官方下载页 下载安装包（swift-6.4.0-RELEASE-windows10.exe），但需要先按手动安装说明装好 Visual Studio 组件。
   • winget 会按电脑的架构自动选择安装包：常见的 Intel / AMD 电脑（x86_64）装 x64 版，骁龙等 ARM 芯片笔记本装 arm64 版，无需手动区分。只有手动下载安装包时才要选对版本，装错会在编译时报 msvcrt.lib 相关错误。

5. 在 VS Code 终端中进入 main.swift 所在文件夹，编译并运行：

   cd C:\swift\hello
   swiftc main.swift -o main.exe
   .\main.exe
   

Windows 上请用 swiftc 先编译再运行，不要用 swift main.swift 直接运行（在 Windows 上不稳定）。

以上步骤来自 Swift 官方文档与官方论坛；Windows 实机效果以群内通知为准。

Mac

先查看芯片和系统版本：左上角苹果菜单 →“关于本机”。

只做第一题：Command Line Tools（体积小）

在“终端”运行：

xcode-select --install

按弹窗提示安装（约 2 GB，同时会装好 git）。运行 xcode-select -p 能看到路径即已安装。完成后进入 main.swift 所在文件夹运行：

swift main.swift

也可以先编译再运行：swiftc main.swift -o main && ./main。

做第三题：Xcode

• Apple 芯片 + macOS Tahoe 26.6 及以上：从 Mac App Store 安装最新的 Xcode 27（Swift 6.4）。Xcode 27 只能在 Apple 芯片的 Mac 上安装。

• Intel 芯片或系统较旧：从 Apple 开发者下载页（需登录 Apple 账号）下载与系统匹配的旧版本：

  你的 macOS	可用的 Xcode	Swift
  Tahoe 26.2 及以上	Xcode 26.6	6.3
  Sequoia 15.6 及以上	Xcode 26.3	6.2
  Sonoma 14.5 及以上	Xcode 16.2	6.0

  以上依据 Apple Xcode 支持页。这些版本都足够完成国庆考核。

• Xcode 本体与 iOS 模拟器是分开下载的：第一次打开 Xcode 时按提示下载 iOS 平台组件。整体建议预留 30 GB 以上磁盘空间，大型下载不要等到截止前再开始。

iPad：Swift Playground

1. 在 App Store 安装 Swift Playground（需要 iPadOS 18 及以上）。
2. 在欢迎页点 “新建 Playground”，选择 Book（游乐场书），得到一个空白的“My Playground”。第一题不要选 App，App 模板需要 SwiftUI 结构，不能直接写顶层代码。
3. 把代码写进去，点击 “运行我的代码”（Run My Code）。
4. 点击 控制台按钮查看 print 的输出（按钮上的圆点表示有新输出）；第一题截图需要清楚显示控制台里的运行结果。

做第三题时再选 App 模板，用 SwiftUI 开发。

在线运行器（仅作临时备用）

装好环境之前，可以用 菜鸟教程在线运行 等网页临时练习语法。第一题提交的运行截图请使用上述本机环境，在线运行器仅供学习练习。

验证安装：运行第一个程序

把下面内容保存为 main.swift 并运行：

let items = ["校园卡", "钥匙", "水杯"]
var packed = ["校园卡"]
packed.append("钥匙")

print("需要带：\(items.joined(separator: "、"))，共 \(items.count) 件")
for item in items {
    if packed.contains(item) {
        print("✓ \(item)")
    } else {
        print("✗ 还缺 \(item)")
    }
}

看到下面的输出，环境就可以用了：

需要带：校园卡、钥匙、水杯，共 3 件
✓ 校园卡
✓ 钥匙
✗ 还缺 水杯

这段代码只用来验证环境，不是第一题的答案。

常见报错

报错或现象	原因与处理
'swiftc' 不是内部或外部命令、command not found: swift	装完没重开终端；重开终端或重启电脑。Mac 运行 xcode-select --install
编译时报 msvcrt.lib、link 相关错误	Visual Studio 组件缺失，或 ARM 电脑装了 x64 版本；重新运行第 2 步的 winget 命令
unable to load standard library for target …	Windows 用户名带空格（Swift 默认装在用户目录下）；在群里求助，干部协助处理
'stdint.h' file not found	电脑装了多个 Visual Studio；在开始菜单打开“x64 Native Tools Command Prompt for VS 2022”再编译
xcrun: error: invalid active developer path	Mac 系统升级后命令行工具失效；重新运行 xcode-select --install
提示需要同意 Xcode 许可	运行 sudo xcodebuild -license，按提示同意
expressions are not allowed at the top level	同时编译了多个 .swift 文件；文件夹里只保留 main.swift，编译时只写这一个文件名
no such module 'SwiftUI' 或 'UIKit'	第一题不需要这些框架；删掉 import 那一行
中文输出乱码	确认 main.swift 以 UTF-8 保存（VS Code 右下角显示 UTF-8）；Windows 可先运行 chcp 65001 再运行程序
提示找不到 winget	在 Microsoft Store 安装或更新“应用安装程序”（App Installer）
下载很慢或失败	换网络（如校园网）重试，尽早开始，不要拖到最后

求助时请提供

• 设备、系统版本、正在走哪条路线；
• 执行的命令或操作，以及完整的报错截图；
• 已经试过哪些办法。