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

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

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

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

npx @convex-dev/bundle-analyzer summary

图标

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

summary

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

npx @convex-dev/bundle-analyzer summary

insights

让你的捆绑变小的建议.

npx @convex-dev/bundle-analyzer insights

components

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

npx @convex-dev/bundle-analyzer components

packages

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

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

files

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

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

modules

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

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

explore

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

npx @convex-dev/bundle-analyzer explore

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

JSON 输出

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

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

所需资源

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

版本匹配

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