Expo CLI 上手实战：6 条命令创建、运行并生成 React Native 原生工程

Expo CLI 上手实战6 条命令创建、运行并生成 React Native 原生工程【免费下载链接】expoAn open-source framework for making universal native apps with React. Expo runs on Android, iOS, and the web.项目地址: https://gitcode.com/GitHub_Trending/ex/expoExpo CLI 是 Expo 框架的命令行工具负责在 Android、iOS 和 Web 上创建、启动、构建和打包 React Native 应用。读完本文你能从零创建项目并在设备上跑起来并且知道每个环节该敲哪条命令。快速上手先说结论Expo CLI 随expo包一起分发不需要单独安装用npx在项目目录里直接调用即可。前置要求只有一个Node.js 22 或更高版本低于 22.13 时 CLI 会打出红色警告。✅ 下面两条命令先看到成功效果新建一个可运行的项目npx create-expo-app hello-expo效果生成一个带默认模板、可立即启动的应用。适用场景每个新项目的起点。进入项目并启动开发服务器cd hello-expo npx expo start效果启动本地开发服务器终端生成二维码。用 Expo Go 扫码可在真机预览也可在终端按w直接在浏览器中打开。命令作用适用场景npx create-expo-app用模板脚手架创建项目项目起步npx expo start启动开发服务器日常开发npx expo run:ios/run:android构建原生应用并启动模拟器/真机完整测试npx expo install安装版本匹配的依赖添加官方库npx expo prebuild生成 android/ios 原生工程需要改动原生代码npx expo export构建生产包发布或部署前核心场景实操在模拟器与真机上运行应用开发服务器跑起来后终端支持按键操作不用反复敲命令# 开发服务器已启动时直接按这些键 r 重新加载 / a 运行到 Android / i 运行到 iOS 模拟器 / w 打开浏览器 / d 开发者菜单当你需要跑一个完整的原生构建而不是在 Expo Go 里跑 JS 包时用run命令npx expo run:ios效果自动完成原生编译并装进模拟器代码改动支持增量更新。适用场景调试原生模块、验证发布前的完整行为。安装依赖不踩版本冲突React Native 生态的包版本之间互相有约束手动npm install很容易装到和当前 SDK 不匹配的版本。expo install会按项目 SDK 版本挑选兼容的库版本npx expo install expo-camera expo-location效果一次装好所有 Expo 官方库版本自动对齐。适用场景给项目添加任何原生能力时。生成可编辑的原生工程平时开发不需要android/和ios/文件夹需要改原生代码时再让 CLI 从配置生成一份npx expo prebuild效果根据app.json配置生成完整的android和ios工程。只想要单端时加--platform android只想生成文件不装依赖时加--no-install。适用场景接入自定义原生代码。构建生产环境包发布前用export生成优化后的产物npx expo export效果把 JS 包和资源打包进dist/目录产物可直接交给 EAS 更新服务或部署到静态服务器。适用场景每次发布之前。进阶技巧用配置插件定制原生工程而不是手改文件直接改prebuild生成的原生文件会在下次生成时被覆盖。正确做法是把定制写进app.json的plugins字段plugins: [[expo-camera, { cameraPermission: 允许访问相机 }]]改完配置后重新执行npx expo prebuild即可生效。这种方式的好处是原生工程随时可以删除重建配置是唯一事实来源。一条命令看清合并后的配置配置分散在app.json、app.config.js、环境变量和插件里出问题时用这条命令查看最终生效的完整配置npx expo config效果打印所有来源合并后的 JSON 配置。适用场景怀疑权限、scheme、图标没生效时的第一排查手段。避坑记录现象运行npx expo init或expo eject提示 is not supported in the local CLI。原因旧版全局 CLI 的命令已被拆分init和eject不在本地 CLI 中。解法建项目改用npx create-expo-app生成原生工程改用npx expo prebuild。现象expo start启动后提示端口被占用服务器起不来。原因默认端口 8081 已被其他进程比如另一个没关的实例占用。解法换端口启动npx expo start --port 19001。现象任何命令执行前都出现红色 Node.js is outdated and unsupported 警告。原因CLI 要求 Node.js 22.13 以上当前版本过低。解法升级到最新的 Node.js LTS 版本用npx expo --version确认 CLI 可正常输出。延伸资源如果某条命令的行为让你意外它的源码就在这个仓库里欢迎顺手提个 Issue 或 PR 帮它变得更好。官方文档开发流程docs/pages/get-started/start-developing.mdxCLI 源码packages/expo/cli/贡献指南CONTRIBUTING.md【免费下载链接】expoAn open-source framework for making universal native apps with React. Expo runs on Android, iOS, and the web.项目地址: https://gitcode.com/GitHub_Trending/ex/expo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考