> 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.

# @lynx-js/lynxtron-rebuild

`@lynx-js/lynxtron-rebuild` 用于将 npm Node.js 原生模块重新编译到 Lynxtron runtime ABI。它对应 Electron 生态中的 `@electron/rebuild`，但目标 runtime 是 Lynxtron。

## 安装

```bash
npm install -D @lynx-js/lynxtron-rebuild
```

## 用法

```bash
npx @lynx-js/lynxtron-rebuild
```

通常在安装或更新原生模块后执行。工具可能复用兼容的预编译产物，因此成功退出不一定表示重新编译了二进制。请检查日志和实际加载的 `.node` 路径，并在目标 Lynxtron runtime 和打包后的应用中调用模块验证。

## 适用场景

| 场景                      | 是否需要                                                    |
| ----------------------- | ------------------------------------------------------- |
| 纯 JavaScript npm 包      | 不需要 rebuild                                             |
| 依赖 Node.js/V8 ABI 的原生模块 | 二进制与 Lynxtron 不匹配时，使用 `@lynx-js/lynxtron-rebuild`       |
| 有兼容预编译产物的 Node-API 模块   | 可以复用；需验证操作系统、架构、Node-API 版本、原生依赖及 Lynxtron 实际加载         |
| 从 Electron 项目迁移过来的原生模块  | Electron ABI 专用二进制需替换为 Lynxtron 构建；兼容的 Node-API 产物可以复用  |
| Lynx 原生能力库              | 通常通过 `npm run build:lynxtron` 构建，不依赖 `lynxtron-rebuild` |

更多说明见 [Node.js 原生模块](/next/zh/lynxtron/Native-Libraries/NodeJS-Native-Modules.md)。
