发现 Swift 作业文件变了、项目无法构建，或运行结果和之前不同？
最快处理：先停止继续让 Claude Code 修改，复制一份当前项目，再查看文件差异；确认改动范围后，从 Git 或课程备份恢复需要的内容，最后用 Xcode 验证。没有备份、也看不懂某项改动时，先别覆盖或删除文件。
适合刚开始学 Swift、用 Claude Code 辅助理解或修改练习代码的学生。
如果只是想从头安装开发工具，本文不是 Xcode 安装教程；这里重点是先保住作业，再有依据地恢复和验证。
Claude Code 修改后 Swift 项目运行不了，先分辨故障表现
“运行不了”不是单一问题。先把现象记录下来，后面才知道该查代码、项目设置还是运行环境。
- 文件内容被改了：打开相关
.swift文件，确认代码、注释或结构具体变在哪里。 - 项目无法构建：记录 Xcode 报错原文，并留意报错指向的文件、行号。不要只记“红了”或“失败了”。
- 能构建，但运行结果变化：写下原先预期和现在实际看到的结果，保留复现步骤。
- 代码变得看不懂：先不要把“看起来复杂”当作损坏，也不要直接整段删掉。它可能是重构，也可能偏离课程要求，需要对照差异判断。
- 项目文件或目录不见了：先检查文件列表和回收站、课程下载目录及备份。仅凭文件名变化，不能判断文件是否可以删除。
暂停继续修改也很重要。Claude Code 的使用方式和权限配置可以参考 Anthropic 的 Claude Code 入门文档与 CLI 使用说明；这些说明能帮助理解工具如何工作，但不能证明某次改动符合课程要求，更不能保证恢复一定成功。
开始排查前，在文件管理器中复制整个项目文件夹，把副本放在另一个位置。给副本起一个容易辨认的名字，例如 Swift作业-排查副本。保留原文件，不要在唯一版本上试着“修到能跑”。
不知道 Claude Code 改了哪些文件，先看文件清单和差异
如果项目使用 Git，打开终端并进入项目目录，先运行：
git status --short
它会列出已修改、新增、删除或未纳入版本管理的文件。简化输出中的 M 常表示修改，?? 表示未跟踪文件；具体状态说明以 Git 的状态命令文档为准。这里出现新文件不代表它一定是垃圾文件，课程资源、测试文件或新建的代码都可能是必要内容。
再看文件名和实际改动：
git diff --name-status
git diff -- ContentView.swift
git diff --name-status 用于快速查看哪些路径有变化；第二条命令查看指定文件的逐行差异。Git 官方的 差异查看文档说明了比较工作区和版本内容的方式。
差异输出通常用减号标出旧内容，用加号标出新内容。比如某行从 Text("Hello") 变成 Text("Welcome")，差异能指出改动，但不会判断哪种写法更符合课程评分标准。逐个检查文件，也要留意项目设置、资源目录和测试文件；不要因为某个文件名陌生，就直接删除它。
如果项目没有 Git，可以对照课程提供的原始文件或自己保存的副本。macOS 终端里可用只读比较命令查看两个文件差异：
diff -u 原始文件.swift 当前文件.swift
把示例中的文件名替换成真实路径。比较结果只帮助找出不同，不会替你选择应该保留哪一版；如果终端提示路径不存在，先核对文件位置，不要把输出重定向到原文件。
没有 Git 记录时，用课程副本逐项恢复
没有 Git 历史，不代表只能重写作业。先复制当前项目，再找到课程下载包、老师提供的模板、自己早先的文件副本或同步盘版本。恢复时只处理能确认来源的文件。
| 选择 | 适合情况 | 主要风险 |
|---|---|---|
| 从课程原始文件复制单个文件 | 能确认该文件本来就应与模板一致 | 可能覆盖自己已完成的作业内容 |
| 从自己的旧副本比对后恢复 | 旧副本时间和来源明确 | 旧版本可能也缺少后续的正确修改 |
| 从 Git 版本恢复 | 已确认需要恢复的文件及目标版本 | 未保存的改动可能被覆盖或丢弃 |
若不确定某文件是课程原始内容还是后来新增，先保留它，并把文件名和差异记下来。不要用一条批量删除或复制命令“清理项目”。对新手而言，先恢复一个确认过的文件、再检查 Xcode 项目，比整目录替换更容易发现误操作。
有 Git 记录时，只恢复确认过的文件或改动
先确认当前分支和工作区状态，再分别查看暂存与未暂存的修改：
git status
git diff
git diff --cached
git diff 查看尚未暂存的差异；git diff --cached 查看已暂存、准备提交的差异。两类内容可能不同，恢复前都要看。若某个文件里只有一部分改动需要撤回，可以先了解 Git 的交互式恢复方式，再逐段选择，而不是整份文件回退。
确认只恢复某个文件，且知道工作区内容将被替换后，才考虑：
git restore --worktree -- 文件路径
这会从索引版本恢复工作区中的指定路径。若需要从某个已提交版本取回文件，先用 git log --oneline -- 文件路径 查看提交记录，再核实目标提交，才考虑：
git restore --source=提交标识 --worktree -- 文件路径
git restore 的默认来源和 --source 用法见 Git 官方恢复文档；查看文件提交历史可参考 Git 的日志命令说明。这些命令会改写指定路径的内容，因此必须先留好项目副本，并确认目标文件、版本和未提交改动。不要在不清楚影响范围时运行面向整个项目的恢复命令。
代码能运行，也要对照课程要求检查
构建成功只说明 Xcode 能完成当前构建过程，不代表作业功能正确，也不代表代码结构符合老师的要求。按作业说明逐项核对：要求实现的功能是否存在、指定文件或类型是否还在、界面或输出是否符合预期、提交文件是否齐全。
然后逐段理解改动。可以要求 Claude Code 解释某个函数做什么、为什么要改，但把解释当作学习材料，而不是正确性证明。至少应能说清输入是什么、结果如何产生、改动影响哪个功能；说不清的代码先标记出来，找老师、助教或同学确认，不要直接提交。
如果课程明确要求独立完成某部分，也要遵守课程关于 AI 辅助的规则。保留自己的原始版本、检查后的差异和测试结果，比单纯保存一份“能运行”的代码更容易说明作业是如何完成的。
恢复后仍无法构建，分开检查代码、设置和环境
先重新打开正确的工程文件，在 Xcode 中查看完整错误信息。构建失败可能来自 Swift 代码，也可能与项目配置、目标平台、资源引用或当前开发环境有关。Apple 的 Xcode 文档介绍了构建和运行应用的工作流；项目构建阶段还可能包含源文件、脚本和资源等设置，可对照 Apple 关于配置构建阶段的说明。
按下面顺序排查，避免把环境问题误当成代码损坏：
- 确认打开的是副本还是原项目，并确认工程与目标方案正确。
- 保存完整报错文字、涉及文件和行号；不要只截取最后一条提示。
- 检查报错位置附近的代码，再对照刚才查看过的差异。
- 查看项目目标平台及构建设置；若提示开发工具或系统版本不匹配，核对 Apple 发布的 Xcode 系统要求。
- 在 Xcode 中重新构建，再按作业要求运行到相应模拟器或设备；分别记录构建结果和实际运行结果。
若课程任务确实要求 macOS 和 Xcode，而手边没有可用的 Mac，先查课程是否允许使用远程开发环境。Apple 的 Xcode 页面列出该工具用于 Apple 平台应用的开发；能否完成特定课程任务，还要看课程要求、项目设置和可用环境，不能只凭“项目能打开”下结论。
排查与环境准备是两件事：先在副本中确认恢复结果，再决定是否需要借用或租用 Mac。可以先看 NUMACS 的远程 Mac 入门说明，并通过 方案对比页面了解远程与本地环境的取舍；若课程对设备、账号或测试方式另有规定，应以课程要求为准。
如果现在依赖 Windows 或临时借来的电脑，常见的不便是无法直接使用 macOS 专属开发工具、设备和时间受限、每次切换环境都要重新确认文件版本。对只需短期完成课程项目或验证恢复结果的学生，远程使用 NUMACS 的 Mac 环境可以作为一种替代选择；如果要长期高强度开发、必须连接本地设备或需要稳定使用实体接口，自购 Mac 或学校提供的设备可能更合适。先保留项目副本，确认课程允许的开发环境，再决定是否需要远程使用，别把租用环境当作恢复代码的前提。
NUMACS 云端 Mac
在 NUMACS 上安全验证 Swift 作业
文件异常或改动难以判断时，先保留现有项目，再用 NUMACS 独享物理 Mac 检查 Swift 项目的编译与运行结果。