快速开始

环境要求

• Node.js 使用当前 Expo 支持的 LTS 版本；
• 真机可安装 Expo Go 或 development build；
• Android 本地构建需要 Android Studio、Android SDK 和模拟器；
• iOS 本地构建与模拟器仅支持 macOS，需要 Xcode；
• 云端 EAS Build 不要求本机安装完整原生构建环境。

创建项目

npx create-expo-app@latest my-app
cd my-app
npx expo start

默认模板使用 TypeScript 和 Expo Router。Metro 启动后，可通过终端提示打开 Android、iOS 或 Web，也可以由真机扫描二维码连接开发服务器。

开发方式

Expo Go

Expo Go 无需为每次启动编译原生应用，适合验证基础组件、样式和 JavaScript 逻辑。它只包含预先集成的原生模块，无法代表完整的生产环境。

Development build

Development build 是包含 expo-dev-client 的项目专用调试应用，可以使用项目实际依赖的原生模块和配置。

npx expo install expo-dev-client
npx eas-cli@latest build:configure
npx eas-cli@latest build --profile development --platform android

也可以在本地生成并运行原生工程：

npx expo run:android
npx expo run:ios

run:ios 仅能在 macOS 上执行。首次运行会生成 android 或 ios 目录。

安装依赖

Expo 项目中的 React Native 依赖优先使用 expo install：

npx expo install package-name

该命令会根据当前 Expo SDK 选择兼容版本。纯 JavaScript 包可以继续使用项目包管理器安装。

环境检查

npx expo-doctor

expo-doctor 用于检查依赖版本、应用配置和常见兼容性问题。环境异常时应先解决检查结果，再清理缓存或重新安装依赖。

参考资料

• 创建 Expo 项目
• Expo development build
• React Native 环境配置