@babylonjs/inspector

中文文档
9.35.0发布于 2026/11/07Apache-2.0TypeScriptESM + CJS零依赖近 30 天下载 17.2万

巴比伦巡视员是一个诊断工具,可以查看并编辑场景图,场景内实体的属性等.

中文使用文档
文档目录4 节
  1. 安装
  2. 巴比伦语Name
  3. 无头可视( 无 UI)
  4. 首席调查员

巴比伦JS督察

巴比伦巡视员是一个诊断工具,可以查看并编辑场景图,场景内实体的属性等.

探长可以多学点 文档。 。 。 .

安装

使用 npm 安装软件包 :

npm install @babylonjs/inspector

最简单的使用方式 Inspector 即唤作 ShowInspector 函数,通过您的场景:

import { ShowInspector } from "@babylonjs/inspector";

// Your code that sets up a Babylon.js scene...

ShowInspector(scene);

巴比伦语Name

最初的巴比伦Lite Victor可以显示与引擎相关的表面和渲染环境:

import { ShowInspector } from "@babylonjs/inspector/lite";

ShowInspector(engine);

无头可视( 无 UI)

无需通过电话通知UI督察 就可以让CLI检查场景 StartInspectable数字 :

import { StartInspectable } from "@babylonjs/inspector";

// Your code that sets up a Babylon.js scene...

const token = StartInspectable(scene);

// When you're done, dispose the token to disconnect:
token.dispose();

StartInspectable 将场景连接到巡视CLI桥上,使CLI命令像查询实体,取出截图,并捕捉性能痕迹——都无需渲染出任何巡视UI. ShowInspector 自动调用 StartInspectable 内部.

首席调查员

虽然监察官UI是为人类设计的,而监察官CLI是为AI特工设计的. 它提供方便机器的JSON输出,用于查询场景实体,捕捉截图,收集性能数据等.

要开始 :

npx @babylonjs/inspector --help

版本与发布记录

@babylonjs/inspector 共发布 895 个版本,首次发布于 2019/01/11;过去 12 个月发布了 172 个版本。

版本发布日期距今
9.35.0latest2026/11/071 天前
9.34.02026/11/052 天前
9.33.32026/11/052 天前
9.33.22026/11/034 天前
9.33.12026/10/308 天前
9.33.02026/10/299 天前

其他发布通道:preview → 8.48.1-preview。

关于 @babylonjs/inspector 的常见问题

@babylonjs/inspector 是什么?

巴比伦巡视员是一个诊断工具,可以查看并编辑场景图,场景内实体的属性等.

如何安装 @babylonjs/inspector?

在项目目录运行 npm install @babylonjs/inspector,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(>=16.14.0 <20.0.0)、react-dom(>=16.14.0 <20.0.0)、usehooks-ts(^3.1.1)、@babylonjs/gui(^9.0.0)、@babylonjs/core(^9.0.0)、@babylonjs/addons(^9.0.0)、@babylonjs/loaders(^9.0.0)、@babylonjs/materials(^9.0.0)、@babylonjs/gui-editor(^9.0.0)、@fluentui/react-icons(^2.0.310)、@babylonjs/node-editor(^9.0.0)、@babylonjs/serializers(^9.0.0)、@fluentui/react-charts(^9.3.27)、@fluentui/react-utilities(^9.26.2)、@fluentui/react-components(^9.70.0)、@babylonjs/node-geometry-editor(^9.0.0)、@babylonjs/node-particle-editor(^9.0.0)、@babylonjs/node-render-graph-editor(^9.0.0)、@fluentui-contrib/react-virtualizer(^1.0.0)、@fluentui-contrib/react-resize-handle(^0.8.4)、@fluentui/react-motion-components-preview(^0.15.2)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。它还提供命令行工具 babylon-inspector,可以用 npx babylon-inspector 直接运行。

@babylonjs/inspector 支持 TypeScript 吗?

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

@babylonjs/inspector 支持 ESM 还是 CommonJS?

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

@babylonjs/inspector 可以商用吗?

@babylonjs/inspector 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@babylonjs/inspector 的下载量有多少?

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

@babylonjs/inspector 还在维护吗?

最新版本 9.35.0 发布于 2026/11/07(1 天前);至今共发布 895 个版本,其中过去 12 个月发布了 172 个;首次发布于 2019/01/11。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。