症状：Expo Go 原生模块报错，依赖已经装好，运行时还是提示找不到实现。
最快解法：先确认模块是否在 Expo Go 内置库中；若项目需要的原生代码不在其中，就改用 development build（为你的项目单独构建的练习版 App），不要继续反复重装。
正在跟课程制作 Expo 或 React Native App、第一次遇到原生模块错误的学生，可以用本文判断是否到了离开 Expo Go 的阶段。
如果你只有 Windows 或学校电脑，也能据此分清云端构建、实体设备与 Mac 模拟器各自能做什么。
已经接入原生依赖、需要检查模拟器结果的初学者，可以按文中的步骤验收。
Expo Go 原生模块报错：先分清依赖、JavaScript 与原生实现
不是所有报错都表示 Expo Go 不支持你的项目。先看错误出在哪一步，再决定该修安装、改代码，还是换开发构建。
| 你看到的现象 | 优先检查什么 | 下一步 |
|---|---|---|
| 安装依赖时失败，项目里没有对应包 | 命令是否在项目目录执行；安装日志是否提示版本或网络问题 | 先解决安装错误，再运行项目 |
| App 已启动，报错指向变量、函数或组件 | 报错文件与代码行；近期修改的 JavaScript 或 TypeScript | 修正代码，不要先重建原生 App |
| 界面能打开，调用某项功能时提示原生模块不存在 | 该库是否需要原生代码；Expo Go 是否内置它 | 查官方支持范围；若缺少原生实现，再评估开发构建 |
Expo Go 可以理解为一个预先打包好的练习应用，内置的是固定的一组原生库。把 JavaScript 依赖装进项目，不等于把它的原生部分也装进 Expo Go。先核对 Expo 官方的第三方库支持清单；如果模块不在清单中，再看 Expo 对开发构建与 Expo Go 的说明。
⚠️ 如果错误发生在依赖安装阶段，先别急着升级构建方式。依赖缺失、代码异常和运行时找不到原生实现，是不同故障。先看终端日志和报错堆栈，避免把普通代码问题误判成 Expo Go 的限制。
什么时候该从 Expo Go 换成 development build？
当课程项目依赖的原生代码不在 Expo Go 里，或你需要验证自己的原生配置时，就该考虑 development build。它不是给 Expo Go 加插件，而是把项目所需的原生部分一起构建成自己的练习版 App。可以查看 Expo 官方开发构建指南了解两者的用途区别。
| 路线 | 适合做什么 | 主要限制 |
|---|---|---|
| 继续用 Expo Go | 学 JavaScript、做界面、练习它内置的库 | 不能补进未内置的原生实现 |
| EAS Build 云端构建 | 在 Windows 上发起 iOS 云端构建 | 构建完成不代表 Windows 能运行 iOS 模拟器 |
| 实体 iPhone | 在真实设备上测试适用于设备的开发构建 | 需符合项目与课程对安装、签名等方面的要求 |
| macOS 上的 iOS 模拟器 | 检查模拟器中的启动、界面和交互 | 模拟器必须运行在 macOS 上 |
EAS Build 可以理解为“云端代构建”。Expo 官方文档说明，iOS 构建可以交由云端处理；但这不等于在 Windows 本机运行模拟器。你可以对照 Expo 的 iOS 模拟器指南确认平台边界。
如果你只是写界面、学 JavaScript，继续用 Expo Go 通常步骤更少。如果课程要求调用当前不支持的原生模块，就切换开发构建；如果验收要求明确写着 iOS 模拟器，或要用 Xcode 调试，再准备 macOS 环境。
第一步：核对模块支持，再决定是否需要重建
打开目标依赖的官方文档，检查它是否需要原生代码、是否支持 Expo，以及是否需要 app 配置或 config plugin。再对照 Expo Go 支持清单。不要仅凭“安装成功”就认定它一定能在当前运行环境中工作。
- ✅ 文档说明不需要自定义原生代码，且库在 Expo Go 支持范围内：检查依赖版本、配置与 JavaScript 调用。
- ⚠️ 文档要求原生代码，但支持开发构建：评估是否升级，并按库的说明完成配置。
- ❌ 项目缺少必需配置，或课程环境不允许添加原生部分：先问课程负责人是否接受替代库或实体设备测试。
Expo 的自定义原生代码指南介绍了通过开发构建使用自定义原生代码的方式。具体依赖仍要按它自己的安装和配置要求处理；development build 不会自动替你补齐所有配置。
第二步：新增原生依赖后，重新构建开发版
已经装好 development build，后来新增原生依赖却仍提示找不到模块？先判断这次改动有没有影响 App 的原生部分。只改 JavaScript 或样式时，通常可以刷新现有开发版；安装或更新带原生代码的库、调整原生配置后，则应重新构建。详见 Expo 关于使用开发构建的说明。
按这个顺序检查：
- 保存项目改动，确认依赖已加入当前项目。
- 对照依赖文档检查安装、插件与 app 配置。
- 判断改动涉及原生依赖或配置，还是只涉及 JavaScript。
- 只改 JavaScript 时，启动开发服务器并连接现有开发版 App。
- 原生部分有变化时，按项目配置重新生成或构建开发版。
- 记录构建方式、目标设备和错误信息，避免误用旧版开发 App。
如果通过 EAS Build 构建，项目会交由云端构建环境处理。提交前先检查仓库内容，不要把账号凭证或项目密钥写进公开代码库。还要注意，客户端代码中的变量不能当作秘密；可参考 Expo 关于 EAS 环境变量的文档选择适合的管理方式。
Windows 上继续做 iOS 项目：分清构建和验收
Windows 可以用来编辑 Expo 项目，也可以发起云端 iOS 构建；这不代表你能在 Windows 本机启动 iOS 模拟器。模拟器是运行在 Mac 上的练习设备。若课程要求模拟器验收，就要安排 macOS 环境；若课程接受实体设备测试，则按项目条件考虑 iPhone。
场景案例：你在学校的 Windows 电脑上完成课程界面，又加入了一个需要原生实现的库。你可以继续在 Windows 编码，并尝试云端构建；如果课程只要求检查设备上的运行结果，符合项目要求的实体 iPhone 可能更直接。若老师要求模拟器截图，或你必须使用 Xcode 调试，就需要学校 Mac 或远程 Mac。并不是每个 Expo 项目都必须租 Mac，先看清课程验收要求。
| 任务 | Windows 电脑 | 云端构建 | 学校 Mac 或远程 Mac |
|---|---|---|---|
| 编辑项目、修改 JavaScript | 可以 | 不负责编辑 | 可以 |
| 创建 iOS 构建 | 可发起云端构建 | 负责构建 | 可在 macOS 环境处理本机构建 |
| 运行 iOS 模拟器 | 不可以 | 不提供 Windows 本机模拟器 | 可以 |
| 用 Xcode 检查模拟器表现 | 不可以 | 不负责本机调试 | 可以 |
云端构建和本机模拟器是两条不同的路线。Expo 的模拟器构建教程说明如何创建模拟器用的构建并在模拟器中运行；要完成本机模拟器验收，仍需要运行模拟器的 macOS 环境。
第三步：用课程项目逐项验收
修复后，不要只确认“App 打开了”。使用同一个课程项目，逐项检查模块调用、代码刷新和课程要求：
- 开发版能启动：确认打开的是项目自己的 development build，而不是 Expo Go。
- 目标模块能调用：运行课程中实际使用该模块的功能，检查是否还提示原生实现缺失。
- JavaScript 修改能反馈：改一处容易辨认的文案或界面，确认开发服务器连接的是当前项目。
- 构建与设备匹配：确认构建产物适用于目标设备或模拟器，不要把两类产物混用。
- 验收要求已满足：课程要求真机、模拟器或 Xcode 操作时，按要求检查结果；先保存项目改动，避免验收旧代码。
如果你目前只有 Windows，可以继续用 Expo Go 练基础内容，并评估 EAS Build 是否满足课程的构建要求。两者的边界要记住：Expo Go 不能加入未内置的原生代码；云端构建不会让 Windows 获得本地 iOS 模拟器；学校 Mac 则受可用时间限制。只有课程确实要求 Xcode 或模拟器验收时，远程 Mac 才可能是合适的短期补位方案。
如果你只需要临时完成 macOS 上的验收，可以先查看 MACCOME 的远程 Mac 使用入口和 MACCOME 的 Mac 云算力方案说明，再对照课程要求决定是否需要使用。长期、频繁依赖本机调试时，也应比较学校设备、自购 Mac 与远程使用的实际安排；如果项目不需要 Xcode 或模拟器，就没有必要为了 Expo 学习本身额外准备 Mac。