# @eosrio/node-abieos 中文文档

规范地址：https://npmcn.com/package/%40eosrio/node-abieos/

版本：4\.2\.0-f7d5b45
npm 元数据更新时间：2026-05-18T15:59:56.297Z
中文译文更新时间：2026-11-14T11:43:26.886Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40eosrio/node-abieos
原文对照：https://npmcn.com/package/%40eosrio/node-abieos/?lang=original
项目主页：https://github.com/eosrio/node-abieos#readme
源码仓库：https://github.com/eosrio/node-abieos

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：4.2 MB，16 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2020-02-13T18:33:09.620Z
- 最新版本发布：2026-05-18T15:59:56.164Z
- 近 30 天下载量：2060（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：26（近 12 个月 2 个）

## 中文简介

节点绑定活体:使用ABIs进行二进制的JSON转换.

## 安装

```sh
npm install @eosrio/node-abieos
```

也可以使用：`pnpm add @eosrio/node-abieos`、`yarn add @eosrio/node-abieos`、`bun add @eosrio/node-abieos`

## README

# 节点比欧

![CI](https://github.com/eosrio/node-abieos/actions/workflows/build.yml/badge.svg) ![Node-API v9 Badge](https://github.com/nodejs/abi-stable-node/blob/doc/assets/Node-API%20v9%20Badge.svg) [![NPM version](https://img.shields.io/npm/v/@eosrio/node-abieos.svg?style=flat)](https://www.npmjs.com/package/@eosrio/node-abieos) [![Coverage Status](https://coveralls.io/repos/github/eosrio/node-abieos/badge.svg?branch=master)](https://coveralls.io/github/eosrio/node-abieos?branch=master)

节点.js 本地绑定 [阿比欧斯](https://github.com/AntelopeIO/abieos),经过一些改进:

-   内部装入的合同地图
-   删除合同:从内存中去除已装入的合同(现在也用香草活字)

由 Q 制作 [里约会议](https://eosrio.io/)

* * *

**Linux, Windows和macOS 都得到了支持.** Npm 包捆绑一个预建 每个平台的二进制( e)`abieos-<platform>-<arch>.node`装填器选择 运行时右一 -- `npm i` 是在支持的平台上零建起。 大楼 仅需要用于不支持的平台/存档组合或本地 发展(见 [大楼](https://npmcn.com/package/%40eosrio/node-abieos/#readme-building)) (中文(简体) ).

-   包括打字
-   已捆绑的预建二进制 : `linux-x64`, (中文(简体) ), `win32-x64`, (中文(简体) ), `darwin-x64`, (中文(简体) ), `darwin-arm64` (按平台/arch自动加载)
-   Windows 以 MinGW-w64 (GCC) 构建- **未支持 MSVC**: 捆绑的 abieos C++ 需要libstdc++/libc++ 语义 MSVC 的 STL 缺少
-   macOS 以 Xcode 命令行工具构建( Clang/ libc++)
-   现在支持NodeJS,Deno,和Bun runtimes.

## 安装

```shell
npm i @eosrio/node-abieos --save
```

## 使用量

常见JS

```js
const nodeAbieos = require('@eosrio/node-abieos');
```

ES模块(节点JS, Bun)

```typescript
import {Abieos} from "@eosrio/node-abieos";
const abieos = Abieos.getInstance();
```

德诺

```bash
# examples/basic.cjs can be run with:
deno run --allow-ffi --allow-read examples/basic.cjs

# For an example using the published npm package with Deno:
# Check the examples/deno-abieos-test folder
cd examples/deno-abieos-test
deno run --allow-ffi --allow-read main.ts
```

阿宝

```shell
# examples/basic.mjs can be run with:
bun run examples/basic.mjs
```

检查 [实例](https://github.com/eosrio/node-abieos/tree/master/examples) 执行示例文件夹

## 大楼

> 大部分用户都这样 **没有** 需要这个- npm 包件船预建二进制 `linux-x64`, (中文(简体) ), `win32-x64`, (中文(简体) ), `darwin-x64` 财务报告和审定财务报表 `darwin-arm64`。从源头构建 仅供不支持的平台/架构或地方发展之用.

先用分模块的克隆(每个平台都需要):

```shell
git clone https://github.com/eosrio/node-abieos.git --recursive
cd node-abieos
npm install
```

### 链接

我们建议Clang 18建造 `abieos` C++ 库 :

```bash
wget https://apt.llvm.org/llvm.sh
chmod +x llvm.sh
sudo ./llvm.sh 18
```

```shell
npm run build:linux
npm run build
```

### 视窗 (MinGW-w64)

`abieos` 已经 **没有** 以 MSVC 构建 — 它的 C++ 依赖于 libstdc+/ libc++ mSVC的 STL/编译器所编写的标准-图书馆语义和GCC/Clang扩展 不提供,在销售的子模块中无法补齐。 以 取而代之的是MinGW-w64(GCC).

1.  安装 [系统2](https://www.msys2.org/),然后从 MSYS2 外壳安装 工具链( 任何 MinGW- W64 分发方式 `g++`, (中文(简体) ), `ninja` 财务报告和审定财务报表 `dlltool` 著作,例如WinLibs:
    
    ```bash
    pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-ninja
    ```
    
2.  把MinGW -w64放进去 `bin` 打开目录 `PATH` (例如:. `C:\msys64\mingw64\bin`(中文(简体) ) 这样 `g++`, (中文(简体) ), `ninja` 财务报告和审定财务报表 `dlltool` 是可解决的.
    
3.  构建 :
    
    ```shell
    npm run build:win
    npm run build
    ```
    

`build:win` 用忍者生成器驱动 cmake-js 并合成一个 GNU 导入用于节点- API 符号的库,因此生成 `.node` 装入 标准(MSVC-所建)Windows的节点.js.

### 马科斯

安装 Xcode 命令行工具( 提供 Clang 和 libc++) :

```bash
xcode-select --install
```

```shell
npm run build:mac
npm run build
```

### 文档

关于详细和方便用户的文件,包括安装、使用、API参考、错误处理、调试和示例,请参考 [文档](https://npmcn.com/package/%40eosrio/node-abieos/docs/README.md)。 。 。 .

关于贡献准则和开发者文件,请参见 [捐款准则](https://npmcn.com/package/%40eosrio/node-abieos/docs/CONTRIBUTING.md)。 。 。 .

## 常见问题

### @eosrio/node-abieos 是什么？

节点绑定活体:使用ABIs进行二进制的JSON转换\.

### 如何安装 @eosrio/node-abieos？

在项目目录运行 npm install @eosrio/node-abieos，或使用 pnpm add / yarn add / bun add。

### @eosrio/node-abieos 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @eosrio/node-abieos 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @eosrio/node-abieos 可以商用吗？

@eosrio/node-abieos 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @eosrio/node-abieos 的下载量有多少？

根据 npm 官方下载统计，@eosrio/node-abieos 在 2026/10/14 – 2026/11/12 这 30 天内被下载 2,060 次，日均约 69 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @eosrio/node-abieos 还在维护吗？

最新版本 4\.2\.0-f7d5b45 发布于 2026/05/18（5 个月前）；至今共发布 26 个版本，其中过去 12 个月发布了 2 个；首次发布于 2020/02/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。