# @convex-dev/bundle-analyzer 中文文档

规范地址：https://npmcn.com/package/%40convex-dev/bundle-analyzer/

版本：0\.1\.0
npm 元数据更新时间：2026-10-20T00:13:27.368Z
中文译文更新时间：2026-11-10T19:01:10.863Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40convex-dev/bundle-analyzer
原文对照：https://npmcn.com/package/%40convex-dev/bundle-analyzer/?lang=original
源码仓库：https://github.com/convex/convex-backend

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

- 包体积（解压后）：2.2 MB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20\.0\.0
- 运行依赖：1 个
- 首次发布：2026-10-16T18:26:19.249Z
- 最新版本发布：2026-10-20T00:13:27.133Z
- 近 30 天下载量：3848（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 4 个）

## 中文简介

分析您的 Convex 项目,以确定优化捆绑大小的方法 .

## 安装

```sh
npm install @convex-dev/bundle-analyzer
```

也可以使用：`pnpm add @convex-dev/bundle-analyzer`、`yarn add @convex-dev/bundle-analyzer`、`bun add @convex-dev/bundle-analyzer`

## README

# @convex-dev/bundle-analyzer (英语)

> \[注\] 此包为α. 命令和输出形状可能在 释放.

分析您的 Convex 项目,以确定优化捆绑大小的方法 .

从您的工程根目录中运行分析器 :

```sh
npx @convex-dev/bundle-analyzer summary
```

## 图标

开始 `summary` 或者说 `insights`然后钻入任何突出的 `packages`, (中文(简体) ), `files`,或 `modules`。 。 。 .

### `summary`

对你的捆绑的概述:其总规模、最高的见解和最大的见解 组件、软件包和模块.

```sh
npx @convex-dev/bundle-analyzer summary
```

### `insights`

让你的捆绑变小的建议.

```sh
npx @convex-dev/bundle-analyzer insights
```

### `components`

每次运行时每个组件捆绑的大小 。 用它看看哪个 组件将首先查看.

```sh
npx @convex-dev/bundle-analyzer components
```

### `packages`

最大的npm包 横穿你的捆绑。 递出一个软件包看看哪个 您的切入点导入它.

```sh
npx @convex-dev/bundle-analyzer packages
npx @convex-dev/bundle-analyzer packages zod
```

### `files`

你包里最大的个人文件 通过文件路径, 或其中的一部分 一个,比如 `zod@3.25.76/` 用于软件包文件,以查看它是什么模块 被捆绑起来,进口什么.

```sh
npx @convex-dev/bundle-analyzer files
npx @convex-dev/bundle-analyzer files convex/lib/
```

### `modules`

每个模块中运行时负载的代码是多少:模块和 其导入的共享块 。 通过一个模块或块来查看里面的文件, 它进口什么, 哪些模块导入它.

```sh
npx @convex-dev/bundle-analyzer modules
npx @convex-dev/bundle-analyzer modules convex/messages.ts
```

### `explore`

在终端的交互式树图中浏览您的捆绑 。 总规模 包括代码、源地图和外部软件包 节点,匹配 `summary`。 。 。 .

```sh
npx @convex-dev/bundle-analyzer explore
```

运行任何命令 `--help` 以观察其选择. `--limit` 设置行数 每个列表显示。 单位 `files` 财务报告和审定财务报表 `packages` 细节,它也限制切入点 每份副本。 这些命令默认为每条30个列表条目和3个导入链 copy.

### JSON 输出

每一个命令除了 `explore` 带 `--json` 以打印 JSON 来显示 报告,为脚本和AI代理。 透视曝光 `savedCodeBytes` 财务报告和审定财务报表 `savedSourceMapBytes`· ; `savedBytes` 是他们的合并估计节省.

```sh
npx @convex-dev/bundle-analyzer packages zod --json
```

## 所需资源

-   `convex/_generated/` 必须已经存在。 运行 `npx convex dev --once` 或者说 `npx convex codegen` 先说 分析器不生成代码.
-   项目的依赖性必须安装,因为捆绑可以解决 从 `node_modules`。 。 。 .

## 版本匹配

分析员会警告项目是否 `convex` 版本与 分析器的版本 `convex`。在方法上可能略有不同 捆绑者的表现不同 `convex` 各个版本。 计划的未来特征是: 支持分析现有的捆绑,独立于 `convex` 版本.

## 常见问题

### @convex-dev/bundle-analyzer 是什么？

分析您的 Convex 项目,以确定优化捆绑大小的方法 \.

### 如何安装 @convex-dev/bundle-analyzer？

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

### @convex-dev/bundle-analyzer 支持 TypeScript 吗？

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

### @convex-dev/bundle-analyzer 支持 ESM 还是 CommonJS？

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

### @convex-dev/bundle-analyzer 需要什么版本的 Node\.js？

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

### @convex-dev/bundle-analyzer 可以商用吗？

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

### @convex-dev/bundle-analyzer 的下载量有多少？

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

### @convex-dev/bundle-analyzer 还在维护吗？

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