Expo 完整指南：如何用 React 快速跑通第一个跨端应用
【免费下载链接】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
Expo 是一个用 React 构建通用原生应用的框架，同时支持 Android、iOS 和 Web。这篇指南写给刚上手的人：三步跑通第一个应用，外加一个真实场景接入演示和一份避坑清单。
用 React 写移动应用，卡在哪一步
不走 Expo 的裸 React Native 项目，第一道坎往往不是代码而是环境：Android 端要装 JDK 和 Gradle 工具链，iOS 端要配 Xcode 与 CocoaPods，版本还必须和 React Native 依赖库严丝合缝。
环境搭好后，每次改动都要等原生编译出结果，反馈链路太长。Expo 的思路就是把平台差异打包成框架能力，让你只写 React 代码。
用上 Expo 之后，差别在哪
- 环境从几天变成半天：没有它，你得手工装齐 Java、Android SDK、Xcode、CocoaPods；有了它，只要装好 Node.js，一条命令生成预配好的项目。
- 不等编译就能测：没有它，改完代码要等打包跑起来；有了它，启动开发服务器后浏览器直接开页面，或手机扫码真机热更新。
- 原生能力不用写原生代码：没有它，相机、定位要各自维护两套原生实现；有了它，调用
expo-camera、expo-location这类模块即可，原生代码由框架自动接入。 - 小修复不用过应用商店：配合 OTA 更新，JS 层的修复可以直接推给用户。
零基础上手三步走 🚀
第一步，环境准备：装好 Node.js（LTS 版）即可，这是唯一前置条件。
第二步，生成项目：
npx create-expo my-app运行时会让你选模板，生成一个带原生工程目录、可直接运行的项目。
第三步，启动开发服务器：
cd my-app npx expo start跑完终端会给出本地地址和二维码，浏览器打开就能看到 "Welcome to Expo" 的起始页，和下面这张图一样。
场景实战：给应用加上定位
以"展示用户当前坐标"为例。生成项目后先装定位模块：
npx expo install expo-location接入只需三行逻辑：调用Location.requestForegroundPermissionsAsync()申请权限，再用Location.getCurrentPositionAsync()拿到经纬度，把数字渲染到界面上。全程不碰原生工程文件，权限声明在 app.json 里补一行描述即可。
避坑清单：新手最常犯的 5 个错 ⚠️
- 沿用旧命令：
expo init、expo-cli已弃用，现在的入口是npx create-expo和npx expo start。 - SDK 版本混用：装新包时对齐项目 SDK（本仓库中 expo 包为 57.x），版本错位会直接导致原生桥接报错。
- 漏配 iOS 权限描述：定位、通知类功能必须在 app.json 写对应的
NS...UsageDescription，否则授权弹窗不会出现。 - 改了配置不生效：多半是缓存旧配置，给
npx expo start加--clear参数重启。 - 大资源直接提交：图片、音视频放进
assets/目录再相对引用，别散落在源码目录。
仓库里的工具箱 🧰
这个 monorepo 装下了整套框架工具链：
- apps/expo-go/：Expo Go 客户端源码，就是扫码安装的那个免编译预览运行时。
- packages/expo-modules-autolinking/：原生模块自动链接引擎，JS 调用和原生端就是靠它接通的。
- packages/expo-updates/：OTA 更新实现，负责把 JS 修复推送到线上。
- templates/：官方维护的 blank、tabs、default、bare-minimum 四套项目模板。
一句话总结：Expo 是前端开发者跳过原生配置坑、专心写界面的最快路径。入门从 docs/pages/get-started/ 开始，想深挖实现就看 packages/expo/ 和 apps/expo-go/ 两个目录。
【免费下载链接】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），仅供参考
