# @boxdb/cli 中文文档

规范地址：https://npmcn.com/package/%40boxdb/cli/

版本：0\.7\.0
npm 元数据更新时间：2026-10-30T20:51:37.344Z
中文译文更新时间：2026-11-08T14:39:10.639Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40boxdb/cli
原文对照：https://npmcn.com/package/%40boxdb/cli/?lang=original
项目主页：https://lebedev-nikita.github.io/boxdb/
源码仓库：https://github.com/lebedev-nikita/boxdb

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

- 包体积（解压后）：33.9 MB，13 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.18\.0
- 运行依赖：0 个
- 首次发布：2026-10-15T08:03:29.759Z
- 最新版本发布：2026-10-30T20:51:36.999Z
- 近 30 天下载量：1785（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：15（近 12 个月 15 个）

## 中文简介

BoxDB 有已键入的 SQLite 列和可读 YAML 存储的命令行数据库

## 安装

```sh
npm install @boxdb/cli
```

也可以使用：`pnpm add @boxdb/cli`、`yarn add @boxdb/cli`、`bun add @boxdb/cli`

## README

# 框式数据库CLI

BoxDB 命令行数据库,包含已键入的 SQLite 列、 SQL 迁移和 可选择可读的 YAML 存储.

安装方式 [土生土长](https://brew.sh/) 在 macOS 或 Linux 上:

```sh
brew install lebedev-nikita/tap/boxdb
```

Homebrew安装一个独立的二进制,没有Node.js. 苹果硅macOS和 x86-64 Linux 使用放出二进制; Intel macOS 从源头创建和 ARM64 Linux 与罗斯和CMake。 见 [窃听](https://github.com/lebedev-nikita/homebrew-tap#boxdb) 用于发布更新。 升级方式 `brew update && brew upgrade boxdb`。 。 。 .

或者通过 npm 安装 :

```sh
npm install -g @boxdb/cli
```

然后运行 :

```sh
boxdb data.db -e "CREATE TABLE users(name TEXT); INSERT INTO users VALUES('Ada'); SELECT * FROM users;"
```

或者在没有全局安装的情况下运行 :

```sh
npx @boxdb/cli --help
```

Npm包需要 macOS ARM64 (macOS 11+) 或 Linux x64 或 ARM64 上的节点.js 22.18+ 与 glibc 2.35+ (Ubuntu 22.04+或64位Raspberry Pi OS Booktrom+). 所有三个二进制都包含在 npm 包中; 没有 Rust 编译器, 需要安装脚本或额外的下载. 阿尔卑斯山/穆斯尔, Windows, Intel macOS 和 32-bit ARM 不支持此 npm 发布.

要从现有的全球安装中切换,首先安装和验证Homebrew的 二进制为 `"$(brew --prefix)/bin/boxdb" --version`。然后删除旧的软件包 使用它的原始软件包管理器 :

```sh
npm uninstall -g @boxdb/cli
# Or, for a Bun global installation:
bun remove -g @boxdb/cli
```

打开新 shell 或运行 `rehash` 以zsh计(`hash -r` 以击之. 检查 `command -v boxdb` 财务报告和审定财务报表 `boxdb --version`;命令应当通过 乡下人 `bin` 目录.

对于没有节点的Raspberry Pi.js,下载 CLI 存档 [GitHub 发布](https://github.com/lebedev-nikita/boxdb/releases)选择 `aarch64-unknown-linux-gnu` 为64位Raspberry Pi OS取出并运行 `./boxdb`。它需要glibc 2.35+.

运行 `boxdb data.db` 用于交互外壳,或 stdin 上的管道 SQL. `--help` 列出选项和子命令; `.help` 列出 shell 命令.

使用 `boxdb check data.db --full` 为诊断. `boxdb repair data.db repaired.db --rebuild-indexes` 重建索引,以及 `boxdb recover damaged.db recovered.db` 抢救现有数据。 两人都写出新的目的地. 见 [追回合同和限制](https://npmcn.com/package/docs/recovery.md)。 。 。 .

见 [框数据库文档](https://github.com/lebedev-nikita/boxdb#readme) 用于存储格式、支持的类型、迁移和语言客户端.

## 常见问题

### @boxdb/cli 是什么？

BoxDB 有已键入的 SQLite 列和可读 YAML 存储的命令行数据库

### 如何安装 @boxdb/cli？

在项目目录运行 npm install @boxdb/cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 boxdb，可以用 npx boxdb 直接运行。

### @boxdb/cli 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/boxdb\_\_cli 是否存在。

### @boxdb/cli 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @boxdb/cli 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.18\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @boxdb/cli 可以商用吗？

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

### @boxdb/cli 的下载量有多少？

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

### @boxdb/cli 还在维护吗？

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