用途:作为 AI 执行期间读取的 React Native 参考,提供常见陷阱与决策依据,而非面向人的教程。文档建议查阅 docs/architecture/HIERARCHICAL_PLANNING.md 或 docs/getting-started/,并使用 Context7 获取 React Native/Expo 文档。
主要能力(选型标准):FlatList 与 FlashList 的取舍——大型列表用 @shopify/flash-list 的 FlashList,据称快 5-10 倍,简单短列表用 FlatList;存储层级——AsyncStorage 存非敏感键值,SecureStore 存令牌与密钥,MMKV 用于高性能同步访问;Expo 与裸 RN——多数项目用 Expo(EAS Build 处理原生),需要自定义原生模块时用裸 RN;NativeWind 与 StyleSheet——熟悉 Tailwind 用 NativeWind,性能关键视图用 StyleSheet。
常见陷阱:FlatList 始终设置 keyExtractor、getItemLayout(固定高度)、maxToRenderPerBatch、windowSize;避免 ScrollView 与 FlatList 互相嵌套导致布局问题,改用 SectionList 或带 horizontal 的嵌套 FlatList;Platform.select 始终包含 default 以兼容 web;Animated.Value 跨渲染持久,应在 useRef 而非 useState 中创建;用 useWindowDimensions() 而非 Dimensions.get(),前者在旋转时更新;Expo 用 npx expo install 安装兼容版本,npm install 可能装到不兼容版本;优先 react-native-safe-area-context 而非 react-native 的 SafeAreaView,在 Android 上更可靠;深链需同时配置 app.json 的 scheme 与原生 URL schemes 以支持通用链接;生产环境 console.log 会拖慢性能,用 DEV 守卫或 babel 插件剥离。
限制:资料未提供安装命令、版本要求、收费信息或具体代码示例,相关细节暂未提供。