Windows 上的 KMP 项目已经能写共享代码，却卡在 iOS 构建或模拟器验收？
最快解法：继续用 Windows 学共享 Kotlin 代码、做 Android 练习；作业要求 iOS 构建或模拟器结果时，再切换到装有 Xcode 的 Mac。能写共享代码，不等于能在 Windows 上交付 iOS 应用。
这篇适合只有 Windows、正在学 Kotlin 或 Android，想把课程项目扩展到 iOS 的学生；也适合已经写好共享模块，却不确定怎么验收 iOS 的初学者。
如果你需要在借学校设备、安排短期 Mac 环境和调整课程计划之间做选择，先看清楚作业最终要你交什么。
先分清课程要你交什么
Kotlin Multiplatform（KMP）是让项目在不同平台之间复用 Kotlin 代码的方案。它不是“写一次代码，所有平台都能在当前电脑上运行”的保证。
官方项目结构把共享代码、Android 应用与 iOS 应用分开处理：比如 commonMain 放通用代码，androidMain 和 iosMain 对应平台专属代码。可以把它们想成同一份课程作业里的共用讲义和不同实验设备：讲义能共用，实验仍要在对应设备上完成。官方项目结构说明也说明了，不同 source set 面向不同平台。
动手前，把老师的要求分成三类：
- 只学 Kotlin 或检查共享逻辑：在 Windows 写代码、看项目结构，按课程要求完成通用部分。
- 要交 Android 运行结果：在 Windows 继续完成 Android 目标和对应测试；Android 工具也提供 Windows 安装方式。Android Studio 官方安装说明
- 要交 iOS 构建、Xcode 工程或模拟器结果：准备 macOS 主机与 Xcode，再构建并验收 iOS 目标。Kotlin Multiplatform 快速入门明确列出了 iOS 应用的主机要求和运行流程。
这三种交付物差别很大。别因为项目里已经出现 iOS 相关文件夹，就把它当成 iOS 已经构建成功。
Windows 上先完成共享代码与 Android 练习
能做什么：在 Windows 上学习 KMP 的项目组织方式、编写平台无关的 Kotlin 逻辑，并推进 Android 部分。官方快速入门给出了 Windows 环境变量配置示例，也说明 IDE 可用于 KMP 项目；Android 侧工具可按其官方安装指引准备。
不能据此认定什么：代码能编辑、共享模块能看到，不能证明 iOS 应用已经构建，更不能证明 iOS Simulator 已经运行。KMP 的不同目标对应不同构建边界；项目配置也会影响共享模块如何接入 iOS 应用。官方模块配置说明
对新手来说，最容易踩的坑是把一条绿勾当成整门作业通过。Windows 上的 Android 运行成功，只能说明你完成了 Android 这一侧的检查；共享代码能编译，也不能替代 iOS 侧验收。
- ✅ 课程只查共享代码、Kotlin 基础或 Android 页面：先在现有电脑上继续。
- ⚠️ 课程提到 iOS 工程、iOS 构建或模拟器：把 Mac 验收安排进计划。
- ❌ 课程明确要求 iOS 运行结果，却只提交 Windows 上的编辑器截图：不要默认这符合要求，先向老师确认验收材料。
需要 iOS 结果时，按顺序在 Mac 上验收
iOS 构建需要 macOS 主机和 Xcode。KMP 官方教程说明，运行 iOS 应用时会调用 Xcode 构建，再启动 iOS Simulator。Apple 的设备运行说明也把选择运行目标、构建并运行列为 Xcode 验收流程的一部分。
到 Mac 上之后，按这个顺序检查，避免到了提交前才发现缺少环境：
- 先核对作业要求。确认老师要的是构建成功、模拟器运行、截图，还是还要提交 Xcode 工程或真实设备结果。
- 准备同一份项目版本。提交当前代码和必要配置；记下仓库版本或提交记录，避免 Windows 与 Mac 上检查的不是同一份代码。
- 检查 Xcode 是否能正常使用。按课程说明准备所需工具，并首次打开 Xcode 完成初始化。Kotlin 官方快速入门也提醒，Xcode 更新后可能还需要启动并安装对应工具。
- 检查 iOS 工程和目标。确认项目包含课程要求的 iOS 部分，IDE 能识别相应运行配置。项目里有共享模块，不代表 iOS 工程和依赖设置一定齐全。
- 确认模拟器可用，再执行运行。在 Xcode 或项目支持的运行配置里选择可用的 iOS Simulator，先观察构建结果，再确认应用是否启动。KMP 首个项目教程介绍了 iOS 工程与模拟器的基本关系。
- 保存验收证据。记录项目版本、构建报错或成功状态，以及老师要求的运行截图。若失败，先分清是代码错误、项目配置问题，还是 Mac 上的 Xcode 或模拟器尚未准备好。
Apple 说明，模拟器运行于 Mac，设备列表也取决于项目目标和已安装的平台支持。Xcode 模拟设备运行文档同时指出，模拟器不等同于真实设备；如果作业要求实机测试，模拟器截图不能替代实机验收。
另外，Xcode 与 macOS 有版本兼容要求，别只看项目里的 Kotlin 插件版本。Apple 的 Xcode 系统要求页面列出各版本的系统要求；课程有指定版本时，优先按课程环境核对。
有学校 Mac 时，用仓库接续同一项目
假设你在 Windows 上写完了共享逻辑，学校实验室开放 Mac 时，最稳妥的做法是把同一份项目带过去，而不是把几个源码文件临时发给自己。
- 在 Windows 上把当前项目提交到课程允许使用的版本控制仓库。
- 检查提交里是否包含课程需要的项目配置、资源和说明；不要把个人密钥或不该共享的凭证放进仓库。
- 到学校 Mac 后同步同一版本，先确认项目能打开，再按前面的顺序检查 Xcode、iOS 目标和模拟器。
- 在 Mac 上产生的修改也提交回仓库，保留清楚的版本记录，方便你回到 Windows 继续完成 Android 部分。
Kotlin 官方关于项目配置的说明介绍了共享模块与 iOS 工程可以如何组合，但并没有说 Windows IDE 会自动替你远程驱动 Mac 构建。交接应以仓库同步和 Mac 上的实际构建结果为准，不要把“代码在两台电脑都能打开”当成“iOS 验收已完成”。
借不到 Mac，就按课程阻塞点选下一步
| 你的课程要求 | 现在怎么做 | 验收边界 |
|---|---|---|
| Kotlin 基础、共享逻辑或 Android 练习 | 继续用 Windows 完成对应部分 | 不声称已完成 iOS 构建 |
| 需要 iOS 构建或 Xcode 工程 | 先询问学校是否有合规可用的 Mac | 在 Mac 上按课程要求构建 |
| 需要 iOS Simulator 运行结果 | 安排可用的 macOS 与 Xcode 环境 | 确认模拟器能启动目标项目 |
| 近期无法获得 Mac，且作业不允许延期 | 和老师确认是否能调整验收方式或期限 | 以老师书面确认的要求为准 |
如果你要评估短期远程 Mac，先核实这几件事，而不是先假定连上就能交作业：
- 课程项目能否通过允许的方式接续到 Mac，项目版本是否一致。
- 远程连接是否符合学校的设备与网络规定；不要绕过学校管理要求，也不要共享个人账户凭证。
- 目标 Mac 是否实际具备课程所需的 macOS、Xcode 和模拟器环境。
- 你是否能亲自完成一次项目构建与运行，并按课程格式保存验收材料。
如果课程不检查 iOS，只要求共享 Kotlin 或 Android 结果，继续用 Windows 通常更直接。若 iOS 是必交项，且学校没有可用设备，再评估短期 Mac 环境；预算有限时，可以先查看 KVMNODE 的 Mac 使用选项，核对接入方式、课程项目交接和实际验收条件。你也可以从 KVMNODE 服务入口了解可用方案。远程连接是否顺手、课程工具是否兼容以及能否按时交付，都应先按你的项目实际验证，不要只凭服务介绍作保证。
常见问题
没有 Mac，能不能先学 Kotlin Multiplatform？
可以。先学共享代码与 Android 侧内容；是否需要 Mac，取决于课程是否要求 iOS 构建或运行结果。
Windows 上写的 KMP 项目，怎么完成 iOS 测试？
通过课程允许的方式把同一版本项目接续到 Mac，再检查 Xcode、iOS 工程和模拟器，按要求运行并留存证据。
学习到哪一步需要 Xcode？
当你要构建 iOS 应用、打开 iOS 工程或运行模拟器时，需要使用装有 Xcode 的 macOS 主机。
共享模块能在 Windows 运行，是否代表 iOS 已通过？
不能。共享逻辑和 Android 结果不能代替 iOS 构建或模拟器验收；按课程交付物分别检查。
Windows 足够你迈出 KMP 学习的第一步，但不是 iOS 课程验收的替代环境。先完成共享代码和 Android 练习；确认作业必须交 iOS 构建或模拟器结果后，再安排学校、本地或短期远程 Mac，并以实际构建与运行结果作为验收依据。