阿里聚安全如果你刚接触React Native，大概率会从Expo入手，然后很快撞上第一个坎：怎么让安卓模拟器把它跑起来。Expo本身已经把"启动开发服务器、加载你的代码、预览UI"这套流程简化到近乎傻瓜化，但模拟器这一层却经常让人卡得莫名其妙——设备没识别到、Expo Go装不上、Metro一直停留在打包状态、或者干脆连端口都起不来。
我在这上面折腾过很多次，环境干净的时候五分钟就能亮屏，环境乱的时候能卡到怀疑人生。这篇文章就是把这些零散的报错、官方文档没写明白的细节，以及我实际踩过的坑汇总起来，把"Expo在安卓模拟器上运行"这件事讲透，从环境准备到完整跑通，再到日常开发中的高频问题排查，一步一步来。
1. 为什么说Expo配安卓模拟器是"看着简单、上手折腾"的组合
1.1 Expo把应用跑到模拟器上的底层逻辑
很多新手误以为Expo像安装一个普通APP那样，直接把代码装进模拟器。实际上它的运行模式更像"浏览器访问网页"：Expo CLI在电脑上起一个Metro打包服务，你的JS代码由它实时编译并通过网络推给模拟器里的Expo Go客户端，Expo Go负责渲染和通信。也就是说，Expo Go才是真正运行在安卓系统里的那个APP，你的项目代码本身并不需要"安装"。
理解这一点非常重要，因为后续所有排查基本都围绕三条链路展开：电脑上的Metro服务是否正常监听、模拟器里的Expo Go是否成功安装并启动、两者之间的网络是否通畅。任何一个环节出问题，表象都是"应用打不开"或者"一直loading"，但根因却可能完全不同。我在下文会按照这三条链路逐一拆。
1.2 模拟器方案怎么选：AVD、Genymotion还是真机
安卓模拟器不是只有Android Studio自带的那一个。常见的方案有：
| 方案 | 优点 | 缺点 | 适合场景 |
|---|---|---|---|
| Android Studio自带AVD | 和SDK/ADB集成最稳，免费，配置灵活 | 初次冷启动慢，占用内存较高 | 绝大多数Expo开发场景，首选 |
| Genymotion | 启动快，界面流畅，自带性能指标 | 个人免费版限制功能，需另装ARM转译 | 需要频繁切换多设备配置时 |
| 真机USB调试 | 环境最真实，性能表现可靠 | 需要额外准备数据线，不同品牌驱动麻烦 | 调试定位、相机、推送等真机特性 |
如果你的电脑是近几年的产品，我建议直接选AVD。原因是Expo官方对这一套组合的测试覆盖最多，踩坑资料也最好找。Genymotion虽然启动速度让人眼前一亮，但碰上Expo Go的下载安装反而可能多出ARM架构兼容的麻烦，性价比不高。真机当然是好选择，但前提是你能忍受频繁插拔数据线和处理各个品牌的驱动问题。
1.3 这套方案到底适合谁
如果你属于下面几类情况，Expo搭配安卓模拟器就是你的主线环境：一是电脑在手边但没有安卓手机，或者手机不是Type-C口导致调试不方便；二是你在开发跨平台应用，需要在不同屏幕尺寸上快速验证UI；三是你刚开始学习React Native，不想一上来就碰原生代码编译（那需要Android SDK、Gradle、原生依赖一堆配置，够吃一壶）。
说白了，模拟器方案的核心价值就是把"运行环境"这块复杂度从你身上剥掉，让你把精力放在业务代码上。但"执行环境"简单了，"配环境"的过程就得自己扛住，接下来就是最折磨人的部分。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备：最容易埋雷的三个位置
2.1 JDK和SDK版本匹配问题
很多人卡在第一步不是不会操作，而是版本对不上。当前主流的React Native和Expo SDK要求JDK 17，压低了会有Gradle相关的编译问题，但如果你的电脑里同时装了多个JDK版本，命令行默认指向的可能不是17。我在排查一个持续报"Unsupported class file major version"的问题时，查了半天才发现是shell里JAVA_HOME指向了旧的JDK 11。
建议动手前先在终端里执行java -version和echo $JAVA_HOME确认一下。macOS上常见的坑是只装了JRE没装JDK，Windows上则是路径里有空格导致一些工具解析失败。至于Android SDK，Android Studio安装时会自动带一份，你需要确认SDK Platforms里至少有和你AVD系统镜像匹配的版本，比如选Android 15就装API level 35。这个不匹配的话，模拟器可能在创建阶段就给你颜色看。
2.2 创建AVD时硬件加速选项的取舍
创建AVD（Android Virtual Device）的时候，界面里一堆选项很容易让人眼花。但真正影响能否跑起来的，是"Hardware Acceleration"和"Graphics"这两个。
Graphics选项里有Hardware（硬件GPU）、Software（软件渲染）等模式。追求流畅你就选Hardware，但如果你在显卡驱动比较老或远程桌面环境里，Hardware模式反而会黑屏或花屏，此时切到Software虽然画面有点粘滞，但至少稳定。我建议优先Hardware，出现异常再降级。
硬件加速这块，Windows上通常依赖Intel HAXM或Windows Hypervisor Platform，macOS上依赖Hypervisor.Framework。如果你在BIOS里没开虚拟化，AVD会提示"emulator: ERROR: x86 emulation currently requires hardware acceleration"，然后直接拒绝启动。这个错误网上讨论非常多，但很多人忽略了先检查BIOS里的VT-x/AMD-V开关，改完重启才能生效。
2.3 adb和环境变量必须确认的两件事
adb（Android Debug Bridge）是电脑和模拟器沟通的桥梁。Expo要识别模拟器，本质就是通过adb查询当前连接的设备。所以有两件事必须确认：
第一，adb path是否被终端识别。Android Studio自带adb，但它不在默认PATH里。macOS上它在~/Library/Android/sdk/platform-tools，Windows上通常在%LOCALAPPDATA%\Android\Sdk\platform-tools。如果你在终端敲adb devices提示找不到命令，就得先把这个路径加进PATH。
第二，模拟器进程是否被adb看到。启动模拟器后，执行adb devices应当看到emulator-5554或类似条目。如果这里什么都看不到，后面任何操作都白搭。有一种容易被忽略的情况是手机厂商的USB驱动和adb冲突，导致设备出现在设备管理器里但adb不识别，这时候删掉冲突驱动即可，我在后面排查链里会细说。
提示：不要同时开多个模拟器再敲
adb devices。我看到过新手开了一个AVD又开了一个第三方模拟器，之后Expo提示"Multiple devices available"直接把启动流程卡住的案例。前期老老实实一次只开一个。
3. 从项目创建到模拟器亮屏：完整实操流程
3.1 创建Expo项目并确认依赖
假设你已经有Node.js环境，先全局确保npm或yarn可用。创建项目建议用官方脚手架：
bash复制npx create-expo-app@latest MyProject
cd MyProject
这个命令会生成一个带默认模板的完整项目，里面已经包含expo、react、react-native等核心依赖。创建一个template完成后，别急着启动，先执行npx expo --version确认CLI版本，再执行npm run android之外的启动命令之前，看下package.json里的scripts。新版Expo模板里可能没有直接的android脚本，而是要求你用npx expo start再按a键。这个细节让很多人误以为项目坏了，其实是交互方式改版了。
3.2 启动AVD：命令行与Android Studio两种方式
我习惯优先命令行方式，它更直接：
bash复制emulator -list-avds
这个命令会列出所有你创建过的AVD名称。如果列表为空，说明你还没在Android Studio里创建过虚拟设备，需要先打开AVD Manager新建一个。
确认列表有设备后，执行：
bash复制emulator -avd你的设备名
macOS上emulator命令位于$ANDROID_HOME/emulator/emulator，Linux还要在前面加~/Android/Sdk/emulator/emulator。客户端这边更省事的做法是在Android Studio工具栏直接点设备图标启动AVD，但我自己实测下来，命令行方式更容易看到启动日志，排错信息更直观。两种方式都可以，挑你顺手的。
第一次启动AVD会经历一个冷启动阶段，进度条走得慢是正常的，我的经验是最多等两三分钟还在转圈就得看日志了。启动成功后会弹出模拟窗口，此时先回终端执行adb devices，确认设备状态是device而不是offline。offline状态通常意味着模拟器还在启动中，多等等就好。
3.3 让Expo找到模拟器：start命令的几种姿势
项目目录下执行：
bash复制npx expo start
Metro服务会监听8081端口。看到终端出现一个二维码和几个操作提示后，按a键，Expo会自动尝试连接当前已连接的Android设备/模拟器，并完成两件事：向模拟器安装Expo Go（如果没装的话），然后通过Expo Go打开你的项目。
这里有个容易踩的坑：Expo Go的自动安装需要访问外网下载。网络不通畅的地区或企业内网环境，这一步会让你在终端一直等，直到超时报错。我的建议是提前手动准备Expo Go的APK：在浏览器里搜索Expo Go对应的APK文件，下载后用adb install命令手动装进模拟器，之后再按a键就会快很多，因为Expo检测到已安装就不会重新下载了。
如果你想跳过手动按a，也可以在启动时直接指定平台：
bash复制npx expo start --android
这条命令等于把"按a"的动作合并进启动流程。另外，每次改完代码不需要重启整个流程，Metro的热更新会自动把改动同步到模拟器，这是Expo开发体验中真正爽的部分。
3.4 首次亮屏后应当检查的三件事
模拟器成功加载Expo应用后，先别急着写代码，按我的习惯做三个检查，可以帮你省掉后面几小时的排查时间：
第一，看模拟器里的Expo Go是否能显示项目名称和控制台日志。第二，在终端按下shift+m可以切换Metro的开发者菜单，确认是否显示"Connected to"之类的连接状态。第三，随便改一行App.js的文案，确认热更新能不能在几秒内反映到模拟器屏幕。这三项都通过，说明你的本地开发链路是健康的。
4. 实跑阶段最常见的问题排查链路
4.1 按了a之后没有任何反应
这是最典型的问题：终端里npx expo start正常，二维码也显示出来了，你按下a键，光标闪了一下但什么都没发生，模拟器还是停在桌面。
排查链路我建议这样走：先执行adb devices，如果这里没有emulator-5554或类似条目，说明Expo根本没找到目标设备。接着检查模拟器窗口是否真的处于"解锁桌面"状态，而不是停在开机画面的锁屏。很多人在模拟器还没完全启动时就急着按a，Expo连接时可能拿到了一个未就绪的设备。
如果adb devices有设备但还是无反应，尝试手动触发：
bash复制adb reverse tcp:8081 tcp:8081
这条命令的作用是让模拟器把8081端口反向代理到电脑的8081端口。模拟器里的网络层有个机制，它访问电脑上的localhost时并不是直接通的，需要通过10.0.2.2这个特殊地址或者反向代理来打通。Expo本身会尝试自动配置，但偶尔会失败，手动补上这一条往往是解决办法。
另一种可能：你开了多个终端窗口，其中一个占用了8081端口，导致Metro无法正常对外应答。用lsof -i :8081检查端口占用，把残留的Metro进程清掉再重新npx expo start。
4.2 Expo Go闪退或白屏
Expo Go能装进模拟器，但一打开项目就闪退，这个问题的头号原因通常是版本不匹配。Expo Go客户端和你的项目依赖的Expo SDK版本如果差距过大，客户端会直接拒绝加载并崩溃。解决办法很直接：去package.json里看expo包的版本，然后对照该版本对应的Expo Go安装包重新安装。别想着"新版客户端总该兼容旧项目"，Expo在这方面的兼容策略没那么容忍。
白屏问题则多半出在Metro端。如果你看到终端里Metro正常，但手机上一直白屏，试着用干净缓存重启一次：
bash复制npx expo start --clear
--clear会清掉Metro的缓存。我遇到过好几次代码本身没问题，但缓存里残留了旧模块导致白屏的情况，清一下就活了。如果你之前的项目换过目录或者改过npm依赖，出现这种问题的概率更高。
4.3 Metro一直卡在打包进度条
Metro日志停在"Building JavaScript bundle"或者iOS Bundling complete之后就没有动静。先说结论：绝大多数情况是网络或依赖安装不完整导致的，而不是代码问题。
排查第一步，确认node_modules里没有缺失的包。可以先执行npx expo-doctor（新版提供），它会把依赖、配置、版本等潜在问题一次性检查出来。第二步，如果有自定义的babel配置或者用了额外的transform插件，试着暂时移除它们再打包。第三步，如果项目里引用了本地图片、字体等静态资源，而且路径写错，Metro在打包时会卡住但报错信息不明显，逐个检查资源引用。
另外，Metro的默认包体大小如果很大（比如几百个npm包），首次打包耗时确实可能到两三分钟。不要一看到进度条不动就立刻重启，先等足一杯咖啡的时间再决定要不要干预，特别是Windows上冷启动时磁盘IO容易成为瓶颈。
4.4 端口冲突和网络导致的连不上
Metro默认监听8081，如果你电脑上装了其他开发服务也占用这个端口，Expo启动时通常会提示端口被占用并问你要不要换端口。很多人直接选了"是"，导致Expo使用8082运行，但模拟器里的Expo Go仍然尝试访问8081，于是怎么都连不上。
这种情况正确处理是释放8081端口，而不是换端口。查找占用进程：
bash复制lsof -i :8081
kill -9 进程PID
如果两个端口都不可用，也可以手动指定端口并让Expo Go知道新地址，在Expo Go里修改开发服务器URL，但这就有点绕了，不如清端口来得干净。
网络方向上还有一个坑：如果你在代理环境下开发，Metro的某些请求可能走了代理导致连不上。此时设置环境变量EXPO_NO_PROXY=1，或者临时关闭系统代理再试。这个问题比较隐蔽，因为终端里Metro看起来一切正常，但模拟器里的Expo Go始终报"Could not connect"。
4.5 模拟器本身卡顿拖累开发效率
模拟器卡顿虽然不是报错，但非常影响体验。常见原因有三个：分辨率设得太高、内存分配不足、以及没有开启GPU加速。打开AVD的设置界面，给模拟器至少分配2GB内存（如果你的电脑内存大于16GB，分4GB会更舒服），分辨率不要盲目追求跟真机一致，开发阶段用中等分辨率足够了。
还有一个经常被忽略的选项是"Cold Boot"和"Quick Boot"的关系。关掉模拟器再启动时，默认会走Quick Boot，它利用之前的快照快速恢复，适合连续开发。但如果你改过硬件配置（比如加了内存），必须选择Cold Boot重新冷启动一次，否则快照里还是旧配置，改了半天等于白改。
5. 开发体验优化的进阶操作
5.1 合理使用快照机制减少等待时间
模拟器的Quick Boot本质是把运行中的内存快照保存下来。我个人的经验是：早上开工前，先把模拟器启动到Expo应用加载完成的界面，然后不要直接关窗口，而是让它保持运行。一天之内反复开关项目时，Quick Boot的恢复速度基本都在几秒内，比每次冷启动快一个量级。但是要注意快照会占用额外的磁盘空间，而且如果系统镜像更新了，旧的快照可能失效，到时候手动执行Cold Boot即可。
5.2 用adb reverse解决本机接口访问问题
开发中你经常会遇到模拟器里要访问电脑本地的后端API，比如http://localhost:3000。这里有个经典误区：模拟器里的应用看到的是安卓虚拟机自己的网络栈，localhost指向的是模拟器本身，不是你电脑。有两种解决方式：一是把API地址改成http://10.0.2.2:3000，这是Android模拟器映射到宿主机回环地址的专用IP；二是更推荐的方式，用adb reverse tcp:3000 tcp:3000做反向代理，这样应用代码里可以直接写localhost，不需要根据不同平台改地址。
用adb reverse的好处是代码可以保持和iOS端一致的写法，省去平台判断逻辑。要注意的是，模拟器每次冷启动之后，之前设置的reverse规则会失效，需要重新执行，所以我习惯把它写进项目文档的开机步骤里。
5.3 多设备并行调试时如何锁定目标
如果电脑上同时连着真机和模拟器，或者开了多个AVD，按a键时Expo可能会提示有多台设备并暂停等待选择。但有时候它不会提示，而是默认选了第一台，你盯着模拟器半天不知道为什么不刷新，其实是代码跑到另一台去了。
这时候有两个办法。一是启动Expo时用交互菜单里的"more"选项手动选设备。二是更可控的方式，先不按a，自己在模拟器里打开Expo Go，输入项目的局域网地址来手动连接。Expo的启动界面会展示那条URL，模拟器里可以手工输入。虽然听起来麻烦，但在多设备同时调试的时候反而是最不容易出错的做法。
5.4 把一个可靠的环境状态固化下来
开发环境这种东西，最怕"这次能跑、下次跑不动"。我最后分享一个习惯：把整个环境的关键状态用一份checklist固定下来。我的checklist大概是这样：
- 本机JDK版本确认是17
- Android SDK路径已加入PATH
- 只启动一个AVD，内存不低于2GB
- adb devices能识别模拟器
- Expo项目执行
npx expo start --clear能正常运行 - 模拟器内Expo Go版本与项目SDK版本匹配
每次在新电脑或者新项目里倒腾环境时，我都按这个顺序过一遍，定位问题的速度会快很多。尤其是换电脑之后，你往往不知道环境变量缺了哪个，一张checklist能把你从"全凭记忆"的泥潭里拉出来。跑起来之后，剩下的就交给Expo的热更新了。