# @grafana/levitate 中文文档

规范地址：https://npmcn.com/package/%40grafana/levitate/

版本：0\.18\.0
npm 元数据更新时间：2026-09-29T13:29:14.961Z
中文译文更新时间：2026-11-16T21:53:53.886Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：204 kB，98 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=18\.19
- 运行依赖：9 个
- 首次发布：2021-12-14T07:13:35.074Z
- 最新版本发布：2026-09-29T13:29:14.628Z
- 近 30 天下载量：80187（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：43（近 12 个月 2 个）

## 中文简介

帮助了解由国家预防机制包(或任何类型脚本代码)输出和消费的API的工具.

## 安装

```sh
npm install @grafana/levitate
```

也可以使用：`pnpm add @grafana/levitate`、`yarn add @grafana/levitate`、`bun add @grafana/levitate`

## README

# \* 抵债

[![npm version](https://img.shields.io/npm/v/@grafana/levitate.svg)](https://www.npmjs.com/package/@grafana/levitate) [![npm downloads](https://img.shields.io/npm/dm/@grafana/levitate.svg?color=blue)](https://www.npmjs.com/package/@grafana/levitate) [![CI](https://github.com/grafana/levitate/actions/workflows/ci.yml/badge.svg)](https://github.com/grafana/levitate/actions/workflows/ci.yml) [![prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg)](https://github.com/prettier/prettier) [![TypeScript](https://badges.frapsoft.com/typescript/code/typescript.svg?v=101)](https://github.com/microsoft/TypeScript)

帮助了解由国家预防机制包(或任何类型脚本代码)输出和消费的API的工具.

## 使用量

**比较不同软件包版本的导出**

```bash
# Compare exports of different versions of a package
npx @grafana/levitate compare \
    --prev @grafana/ui@8.2.5 \
    --current @grafana/ui@canary
```

**清单进口**

```bash
# List the imports used by a program
npx @grafana/levitate list-imports \
    --path <PATH-TO-A-PACKAGE>/module.ts \
    --filters "@common/pages" "@grafana/data" \
    --verbose
```

**列表导出**

```bash
# List the exports of a compiled package
npx @grafana/levitate list-exports \
    --path <PATH-TO-A-PACKAGE>/index.d.ts
```

**检查模块和软件包之间的兼容性**

使用特定版本的软件包检查代码的相容性( 如 : @ grafana/ data@ 9. 0.0) 对照同一软件包的另一版本(例如:@grafana/data@ 9.0.5).

```bash
# Check if the current module.ts usage of @grafana/data is
# compatible with the latest version of it
npx @grafana/levitate is-compatible \
    --path <PATH-TO-A-PACKAGE>/module.ts \
    --target "@grafana/data@latest"
```

## 忽略特定导出变化

要忽略特定导出名称中的更改( 添加、 更改、 删除), 您可以创建 `.levignore.js` 在同一个目录中引用起落架.

该文件的格式如下:

```javascript
module.exports = {
  removals: [
    // each entry is a regex
    /Sample\.ignoreThisOne/,
    /Sample\.ignoreThisOneToo/,
    /Sample.*\b/,
    'Sample.ignoreThisOneToo', // strings are converted to regex to match exact
  ],
  changes: [
    //...
  ],
  additions: [
    //...
  ],
};
```

说明:

-   利维塔特会在它检查的任何包中忽略匹配正则exs的符号. 如果多个软件包导出同名符号,它们都会被忽略.
-   这只影响 `compare` 财务报告和审定财务报表 `is-compatible` 命令。 它不会影响 `list-imports` 或者说 `list-exports` 命令.
-   你应该找到自己的位置 `.levignore.js` 在同一个目录中引用起落架.

## 捐款

如果你有兴趣为利维塔特计划捐款,请阅读 [贡献指南](https://github.com/grafana/levitate/blob/HEAD/CONTRIBUTING.md)。 。 。 .

## 常见问题

### @grafana/levitate 是什么？

帮助了解由国家预防机制包\(或任何类型脚本代码\)输出和消费的API的工具\.

### 如何安装 @grafana/levitate？

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

### @grafana/levitate 支持 TypeScript 吗？

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

### @grafana/levitate 支持 ESM 还是 CommonJS？

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

### @grafana/levitate 需要什么版本的 Node\.js？

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

### @grafana/levitate 可以商用吗？

@grafana/levitate 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @grafana/levitate 的下载量有多少？

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

### @grafana/levitate 还在维护吗？

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

