react-native-core

React Native 核心

根据截至 2026 年的 React Native 文档整理。

另请参阅：

• 生态系统库（导航、状态管理、TanStack Query、Reanimated）→ react-native-ecosystem
• Expo SDK 和 EAS 工具 → react-native-expo
• 深入性能优化（FPS、包体积、TTI、内存、原生）→ react-native-performance
• React Native Testing Library 深入指南 → react-native-testing

React Native 让你只用 JavaScript 就能构建移动应用。它采用与 React 相同的设计，让你通过声明式组件组合出丰富的移动 UI。借助 React Native，你可以构建真正的移动应用，其表现与使用 Objective-C 或 Java 构建的应用无异。

核心参考

主题	说明	参考
核心组件	View、Text、Image、TextInput、ScrollView——构建 UI 的基础组件	core-components
Flexbox 布局	用于定位和对齐组件的 Flexbox 布局系统	core-layout
样式	用于创建和组织组件样式的 StyleSheet API	core-styling

功能

动画

主题	说明	参考
Animated API	内置 Animated API——定时、弹簧、组合（复杂场景请使用 Reanimated v3）	features-animations
缓动函数	用于自定义动画曲线和自然运动效果的缓动函数	features-easing

用户交互

主题	说明	参考
触摸处理	用于处理用户输入的 Pressable、Touchable 组件和手势响应器	features-touch-handling
键盘	用于处理键盘事件、收起键盘以及使用 KeyboardAvoidingView 的 Keyboard API	features-keyboard

UI 组件

主题	说明	参考
其他组件	用于对话框、切换控件和加载状态的 Modal、Switch、ActivityIndicator、RefreshControl	components-ui

数据展示

主题	说明	参考
列表	用于高效渲染大型可滚动列表的 FlatList 和 SectionList	features-lists

样式与主题

主题	说明	参考
颜色与主题	用于主题和深色模式支持的颜色、PlatformColor、Appearance API	features-colors-theming

平台集成

主题	说明	参考
平台 API	Linking、Dimensions、Platform 检测、AppState 和原生集成	features-platform-apis
网络	用于 HTTP 请求的 Fetch API（生产应用：Axios + TanStack Query）	features-network
StatusBar	控制状态栏的外观、样式和可见性	features-statusbar
分享与振动	用于触觉反馈的原生分享对话框和设备振动	features-share-vibration
计时器	用于安排任务和延迟的 setTimeout、setInterval、requestAnimationFrame	features-timers
平台专属 API	Android（ToastAndroid、DrawerLayoutAndroid）和 iOS（ActionSheetIOS）的原生模式	features-platform-specific

无障碍

主题	说明	参考
无障碍	屏幕阅读器支持、无障碍标签、角色和状态	features-accessibility

高级样式

主题	描述	参考
变换	用于旋转、缩放、平移和倾斜的 2D 和 3D 变换	features-transforms

架构

主题	描述	参考
新架构	Fabric、JSI、TurboModules — 自 RN 0.76 起默认启用，以及对代码的影响	features-new-architecture

最佳实践

主题	描述	参考
调试	React Native DevTools、LogBox、Dev Menu 和调试技巧	best-practices-debugging

关键建议

• 所有样式都使用 StyleSheet.create()，而不是内联对象
• 长列表使用 FlatList，而不是 ScrollView
• 新的触摸交互使用 Pressable（优先于已弃用的 Touchable 组件）
• 动画：简单场景使用内置的 Animated API 即可；复杂动画或手势驱动的动画使用 Reanimated v3
• 权限：使用 react-native-permissions 处理跨平台权限，而不是底层的 PermissionsAndroid
• 使用 Platform.select() 和 Platform.OS 处理平台差异
• 在真实设备上测试 — 模拟器行为可能与实际设备不同
• 使用 TypeScript，以获得更好的类型安全性和开发体验
• 新架构在 RN 0.76+ 中默认启用 — Fabric、JSI 和 TurboModules 均已启用；请检查库的兼容性