用途:在需要从零创建 React Native 项目、在 React Native CLI 与 Expo 之间选择初始化方式、配置 TypeScript、打包器和原生依赖,或搭建含导航与状态管理的初始项目结构时使用。
主要能力:一键创建项目;选择 CLI 或 Expo;生成 TypeScript 模板;生成目录结构(App.tsx 入口、android/、ios/、src/ 下的 screens、components、navigation,以及 package.json、tsconfig.json、metro.config.js);安装初始依赖并验证在模拟器或设备上构建运行。
使用方式(保持原命令):CLI 初始化使用 npx @react-native-community/cli init MyApp,TypeScript 模板加 --template react-native-template-typescript;Expo 使用 npx create-expo-app MyApp --template blank-typescript。安装依赖 npm install;iOS 安装 CocoaPods 用 cd ios && pod install && cd ..;运行用 npx react-native run-ios 和 npx react-native run-android。工作流为:收集需求(项目名、组织、TypeScript 偏好、Expo 或裸 CLI)、执行初始化、安装初始依赖、验证构建运行。
适用场景:新项目脚手架、跨平台应用起步、需要 TypeScript 与导航/状态管理初始化配置的工程。
限制与最佳实践:添加任一 iOS 原生依赖后需重新运行 pod install;统一跨平台命名与包标识;锁定 Node.js 与 React Native 版本以保证构建可复现;先用默认模板验证可运行再逐步添加功能;尽早配置 CI,包含 run-android 与 run-ios 构建步骤。环境搭建见 https://reactnative.dev/docs/environment-setup,Expo 入门见 https://docs.expo.dev/get-started/create-a-project/。