Neon 支持在 Node App 中嵌入 Rust 代码

Neon 是一个可以使用 Rust 开发原生 Node 模块的库和工具链，类似于使用 C 和 C++所实现的功能，它还利用了 Rust 安全方面的好处。

Neon 致力于让 Node.js 模块的创建变得简单明了。在安装了 Neon 和 Rust 工具链后，你就可以使用 neon new 来创建一个 Node 模块骨架，其中包含了一个 Cargo.toml 文件和一个 Rust 文件(一个示例 hello 函数)：

<project-name>/├── .git ignore├── README.md├── lib/│   └── index.js├── native/│   ├── Cargo.toml│   └── src/│       └── lib.rs└── package.json

你可以在 Cargo.toml 中添加所需的 Rust 依赖项，并按照你喜欢的方式布局代码。你可以通过两个步骤导出 Rust 函数，然后在 Node 程序中使用它。首先是注册函数：

register_module!(mut m, {    m.export_function("myFunction", thread_count)});

然后，在 lib/index.js 中导出：

const addon = require('../native');module.exports = addon.myFunction;

准备好代码后，你就可以构建 Node 模块：

neon build --release

虽然这看起来很简单，但你无论如何都应该特别注意在 Node 环境中表现得像个好公民。特别是你导出的任何一个 Rust 函数都应该是特定类型的：

fn add1(mut cx: FunctionContext) -> JsResult<JsNumber> {...}

这里，可以通过 FunctionContext 访问 Node 调用者环境，包括它的 arguments 列表。类似地，导出的函数应该返回一个 JsResult，这是一个指定了函数返回给定类型或抛出 JavaScript 异常的可选类型。例如，你可以使用以下语法访问特定参数：

let x = cx.argument::<JsNumber>(0)?.value();

要从导出的函数返回值，应该将其转换为预期值。例如，如果你的函数返回一个数字，在返回时你需要使用 Rust 的 as f64 转换操作符对其进行转换：

Ok(cx.number(num_cpus::get() as f64))

构建原生 Node 模块的一个好处是可以执行异步后台任务。Neon 使用 N-API 的微任务API来实现这个目标，并依赖 JavaScript 端的回调和 Promise 来控制异步任务的执行。

Neon 也可以用于 Electron App。目前这需要使用一个中间工具 electron-build-env，用于构建 Electron App 所需的 Neon 依赖项。Neon 团队正在开发electron-rebuild，这个工具将简化这一过程，可以像使用其他依赖项那样使用 Neon 依赖项。

原文链接：

Neon Enables Embedding Rust Code in Node.js Apps