> For AI agents: the complete documentation index is available at /next/zh/llms.txt, the full documentation bundle is available at /next/zh/llms-full.txt.

# ReactLynx 是什么？

ReactLynx 是 Lynx 的官方 React 框架。它允许你用 React 的心智模型开发 Lynx 原生应用。

和在 Web 上使用 React 一样，使用 ReactLynx 时，你可以[使用 JSX 和 React 组件](https://react.dev/learn/describing-the-ui)来构建你的 UI。ReactLynx 会将你的 React 代码转换为对 [Lynx Engine](/next/zh/guide/spec.md#engine) 命令式 API 的调用，从而实现原生 UI 的渲染。

## 主要功能

ReactLynx 本身是“地道”的 React，但也开创性地引入了“双线程 React”、编译协同渲染等优化。

- **“地道”React**：ReactLynx 是 React 的一个实现，本质上基于 [Preact](https://github.com/preactjs/preact)，因此和 React 有基本一致的 API 和行为，此一致性使得很多生态建设可以复用。
- **[双线程编程思想](/next/zh/react/thinking-in-reactlynx.md)**：ReactLynx 遵循 React 的编程模型，但通过利用 Lynx 提供的**双线程运行时**，结合自身的编程范式（或规则）来实现更好的性能和用户体验。
  - **[Off-main-thread](/next/zh/guide/spec.md#background-thread-aka-off-main-thread) Reconciliation**：ReactLynx 通过将部分 Reconciliation 逻辑放到后台线程，以减少主线程的计算量，提升性能。
  - **[双线程架构下的生命周期](/next/zh/react/lifecycle.md)**：由于 Lynx 的双线程架构特点，ReactLynx 的生命周期与传统 React 在调用时机上存在一些差异。
- **[编译协同渲染](/next/zh/react/compiler-informed-rendering.md)**：ReactLynx 会在编译时将 JSX 的静态结构提取为可复用的编译表示，让运行时专注处理动态值和动态子树。

## 如果你是 React Web 开发者

### 需修改包名

由于和 [`react`](https://www.npmjs.com/package/react) 有基本一致的 API，你可以直接将 `react` 替换为 `@lynx-js/react`，然后继续使用你熟悉的 React API。

```diff
- import { useState } from 'react';
+ import { useState } from '@lynx-js/react';
```

有关 ReactLynx 实现的 API 的完整列表，请参阅 [`@lynx-js/react` API 文档](/next/zh/api/react/index.md)。

### 不同的元件集合

不同于 Web 上的 `div`、`span` 等元素，Lynx 提供了一套元素标签集合，例如 `view`、`text`、`image` 等（[完整列表](/next/zh/api/elements/built-in/view.md)）。
在 ReactLynx 中，你可以[组合使用](/next/zh/guide/ui/elements-components.md)这些元素标签来构建你的原生应用。

```diff
- <div className="..." />
+ <view className="..." />
```

虽然元件的命名类似于 React Native，但是 ReactLynx 有一些不同之处：

```diff
- import {View, Text, Image} from 'react-native';
- <View style={{...}} />
+ <view style={{...}} />
```

### 不同的事件命名

基于 Lynx，ReactLynx 使用了一套不同于 Web 的事件命名（前往[事件](/next/zh/guide/interaction/event-handling.md)了解更多）。


事件传播也有所不同

对于 Web 上常用的 `e.stopPropagation()` 和 `e.preventDefault()` 等方法，Lynx 仅在[主线程脚本](/next/zh/react/main-thread-script.md)中支持 [`e.stopPropagation()`](/next/zh/api/lynx-api/event/event.md#stoppropagation)。
但是 Lynx 的[事件传播机制](/next/zh/guide/interaction/event-handling/event-propagation.md)仍允许你实现和 Web 上类似的功能或效果。

```diff
- <button onTouchStart={...} />
+ <view bindtouchstart={...} catchtouchstart={...}/>
```

### 没有 `document` 和 `window`

Lynx 尚未提供 `document` 和 `window` 对象，因此 ReactLynx 也不支持这两个对象。


没有“DOM”？

Lynx Engine 提供了一套 Low Level 的 Element API，
允许[框架开发者](/next/zh/guide/spec.md#scripting-framework-developer)通过运行在[主线程](/next/zh/guide/spec.md#main-thread-or-lynx-main-thread)的 JavaScript 创建 UI。
但这套 API 并不向所有开发者开放。
Lynx 鼓励开发者尽可能使用声明式的方式来构建 UI，而不是直接操作 DOM。
但也提供[直接操作节点](/next/zh/guide/interaction/event-handling/manipulating-element.react.md)的能力和[主线程脚本](/next/zh/react/main-thread-script.md)，
一般用来帮助开发者在实现一些复杂交互时，依然可以保持接近原生的用户体验。

这意味着你无法使用任何依赖于 `document` 或 `window` 的库。

一般来说，你可以通过以下两种方式来解决这个差异：

- 大多数情况下，Lynx 以不同的 API 提供某个功能，例如你可以使用 `lynx` 对象下的 API，以 [`lynx.reload`](/next/zh/api/lynx-api/lynx/lynx-reload.md) 替代 `window.location.reload()`。
- 偶尔 Lynx 并未提供某个功能，你可以使用 Lynx 的 [NativeModules](/next/zh/guide/use-native-modules.md) 和[自定义元件](/next/zh/guide/custom-native-component.md)来扩展 Lynx 的能力。

## 下一步

### 进一步学习 ReactLynx


[Thinking in ReactLynx

学习 ReactLynx 编程思想

](/next/zh/react/thinking-in-reactlynx)[Rendering Process and Lifecycle

理解 ReactLynx 的渲染流程和生命周期

](/next/zh/react/lifecycle)

继续阅读[编译协同渲染](/next/zh/react/compiler-informed-rendering.md)和[主线程脚本](/next/zh/react/main-thread-script.md)，了解框架的渲染机制和主线程交互。

### 构建 ReactLynx 应用

根据你的目标选择阅读方向：


[开发指南

了解编码建议、代码拆分、React Compiler 和代码测试

](/next/zh/react/best-practices)[生态集成

接入数据获取、状态管理、路由和生成式 UI 等生态方案

](/next/zh/react/data-fetching)

**更多内容**：按需查阅 [API 参考](/next/zh/api/react/index.md)，并使用[框架性能分析](/next/zh/guide/performance/analysis-performance/analysis-framework.md)定位性能问题。

### 学习 Lynx 基础

磨刀不误砍柴工。


[使用元件

学习如何在 Lynx 中使用内置元件

](/next/zh/guide/ui/elements-components)[添加样式

学习如何在 Lynx 中编写样式

](/next/zh/guide/ui/styling)




[理解布局

学习如何在 Lynx 中进行排版

](/next/zh/guide/ui/layout)[处理滚动

学习如何在 Lynx 中使用可滚动元件

](/next/zh/guide/ui/scrolling)