Babylon Import Splitter

一个 VSCode 扩展，用于自动拆分 @babylonjs/core 的导入语句，提高应用程序的性能和加载速度。

功能

这个扩展可以将以下格式的 BabylonJS 导入语句：

import { Engine, Scene, Vector3, MeshBuilder } from "@babylonjs/core";

自动拆分为更精确的导入语句：

import { Engine } from "@babylonjs/core/Engines/engine";
import { Scene } from "@babylonjs/core/scene";
import { Vector3 } from "@babylonjs/core/Maths/math.vector";
import { MeshBuilder } from "@babylonjs/core/Meshes/meshBuilder";

这样可以：

• 减小最终打包的体积
• 提高应用程序的加载速度
• 只导入实际需要的模块

使用方法

格式化单个文件

1. 安装扩展后，打开包含 BabylonJS 导入语句的文件
2. 按下 F1 或 Ctrl+Shift+P 打开命令面板
3. 输入 "Split BabylonJS Imports" 并选择该命令
4. 扩展将自动分析当前文件中的 BabylonJS 导入语句并替换为精确的导入

格式化整个工作区

1. 按下 F1 或 Ctrl+Shift+P 打开命令面板
2. 输入 "Format All BabylonJS Imports in Workspace" 并选择该命令
3. 扩展将自动搜索工作区中的所有 TypeScript 和 JavaScript 文件
4. 对每个文件应用 BabylonJS 导入格式化
5. 显示进度条和完成消息，告知处理了多少文件以及修改了多少文件

刷新导入映射

如果您发现某些 BabylonJS 组件（如 GlowLayer 或 Nullable 等）显示为"未知导入"，可以使用此功能刷新导入映射：

1. 按下 F1 或 Ctrl+Shift+P 打开命令面板
2. 输入 "Refresh BabylonJS Import Mappings" 并选择该命令
3. 扩展将重新扫描项目中的 node_modules/@babylonjs/core 目录，自动识别更多的导入组件
4. 刷新完成后，再次运行格式化命令，之前的"未知导入"应该能够被正确识别

安装

从 VSIX 文件安装

1. 下载提供的 .vsix 文件
2. 在 VSCode 中，点击 "扩展" 侧边栏
3. 点击 "..." 菜单，选择 "从 VSIX 安装..."
4. 选择下载的 .vsix 文件

从源代码安装

1. 克隆或下载此仓库
2. 在项目根目录运行 pnpm install 安装依赖
3. 运行 pnpm run compile 编译代码
4. 按 F5 在新的 VSCode 窗口中调试扩展

注意事项

• 此扩展需要在项目中安装 @babylonjs/core 包才能正常工作
• 扩展会自动分析 node_modules/@babylonjs/core 目录中的文件结构来生成导入映射
• 如果某些导入无法识别，将会添加注释标记

版本历史

0.0.1

• 初始版本
• 支持基本的 BabylonJS 导入拆分功能

贡献

欢迎提交问题报告和功能请求！

祝您使用愉快！