用途:为 React Native 和 Expo 应用开发提供一套分优先级的实践规则,用于提升性能与交互质量。适用场景包括构建 React Native/Expo 应用、优化列表与滚动性能、使用 Reanimated 实现动画、处理图片与媒体、配置原生模块或字体,以及组织带原生依赖的 Monorepo 项目。
主要能力(按优先级): 列表性能(CRITICAL):大列表使用 FlashList 虚拟化,记忆化列表项组件,稳定回调引用,避免内联样式对象,将函数提取到渲染外,优化列表内图片,把昂贵计算移出列表项,异构列表使用 item types。 动画(HIGH):仅动画化 transform 和 opacity,用 useDerivedValue 处理计算型动画,用 Gesture.Tap 替代 Pressable。 导航(HIGH):优先使用原生 stack 和原生 tabs 而非 JS 导航器。 UI 模式(HIGH):图片统一用 expo-image,图片灯箱用 Galeria,用 Pressable 替代 TouchableOpacity,ScrollViews 处理安全区域,头部使用 contentInset,使用原生上下文菜单与原生模态框,用 onLayout 而非 measure(),样式使用 StyleSheet.create 或 Nativewind。 状态管理(MEDIUM):最小化状态订阅,回调使用 dispatcher 模式,首次渲染显示 fallback,为 React Compiler 解构函数并处理 shared values。 渲染(MEDIUM):文本包裹在 Text 组件中,避免用 falsy && 做条件渲染。 Monorepo(MEDIUM):原生依赖保留在 app 包内,各包使用统一版本。 配置(LOW):自定义字使用 config plugins,规范设计系统导入目录,提升 Intl 对象创建。
使用方式:按需阅读单条规则文件,如 rules/list-performance-virtualize.md、rules/animation-gpu-properties.md,每条规则含原因说明、错误示例、正确示例与补充参考;完整合集见 AGENTS.md。
限制:资料未提供具体安装命令、包管理配置、支持的 React Native/Expo 版本、收费信息或性能提升的量化数据,这些内容暂未提供。