vscode 默认不提供 babylon.js 类型提示，因 script 引入时未加载类型定义；必须手动接入 babylon.d.ts 文件，并配置启用 checkjs 的 jsconfig.json，否则 babylon. 无补全。
直接用 script 标签引入 Babylon.js 时，VSCode 默认不提供任何类型提示——这不是你配置错了，是它根本没加载类型定义。要让 BABYLON.Engine、BABYLON.Scene 这些类名和方法有补全、跳转、参数提示，必须手动接入类型声明文件（.d.ts），且不能依赖 @types/babylonjs（npm 安装后通常不生效）。
为什么 @types/babylonjs 在 JS 项目里基本无效
VSCode 的 JavaScript 智能提示依赖 jsconfig.json 的 typeAcquisition 或显式 /// <reference></reference>，而 @types/babylonjs 的导出结构与 Babylon.js 的 UMD 全局变量模式不匹配。你 npm install 后，BABYLON 对象在全局存在，但 TypeScript 类型系统找不到它的根命名空间映射。
- 现象：输入
BABYLON.后无任何提示，或只提示any类型 - 根本原因：Babylon.js 发布包自带
babylon.d.ts，但未通过标准types字段暴露给 JS 项目 - 替代方案：直接复用官方发布的
babylon.d.ts，并确保 VSCode 能定位到它
手动接入 babylon.d.ts 的两种可靠方式
推荐从 Babylon.js 官方 CDN 下载最新版类型文件，路径为：https://cdn.babylonjs.com/babylon.d.ts。保存为本地 types/babylon.d.ts（或任意你喜欢的目录）。
- 方式一（单文件轻量）：在 JS 文件顶部加一行
/// <reference path="./types/babylon.d.ts"></reference>，路径按实际调整 - 方式二（项目级统一）：把
babylon.d.ts放进node_modules/@types/babylonjs/index.d.ts（需手动建目录），再在jsconfig.json的typeAcquisition.include加上"babylonjs" - 注意：无论哪种方式，
jsconfig.json必须存在且启用"checkJs": true，否则 JS 文件不参与类型检查
jsconfig.json 的最小必要配置
这个文件必须放在项目根目录，内容不能省略关键项。常见错误是漏掉 include 或写错 glob 模式，导致 VSCode 根本不扫描你的 JS 文件。
{
"compilerOptions": {
"checkJs": true,
"target": "es2017",
"module": "none"
},
"typeAcquisition": {
"include": ["babylonjs"]
},
"include": ["**/*.js"],
"exclude": ["node_modules"]
}
-
"module": "none"是关键：Babylon.js 全局脚本模式下，设成commonjs反而会干扰模块解析 -
"include"必须覆盖你的源码路径，比如用["src/**/*.js"]就不会提示index.html同级的main.js - 改完配置后，重启 VSCode 或执行
Developer: Reload Window，否则不生效
AR/VR 开发时额外要注意的提示断点
如果你在做 WebXR 或 Rokid JSAR 开发，BABYLON.WebXRDefaultExperience、createDefaultXRExperienceAsync 这些 API 的类型往往比基础渲染更晚被识别——因为它们不在主 babylon.d.ts 中，而是独立发布在 @babylonjs/core 的子模块里。
- 解决办法：改用 ES 模块导入（哪怕只是开发期），例如
import * as BABYLON from '@babylonjs/core'，此时@types/babylonjs才真正起作用 - 但注意：这要求你用构建工具（如 Vite/Webpack），纯
script引入无法触发模块类型解析 - 折中方案：对 XR 相关代码单独建一个
.ts文件，用 TS 编译保障提示完整，其余逻辑仍用 JS +babylon.d.ts
最易被忽略的一点：Babylon.js 的类型定义严重依赖浏览器环境（比如 WebGLRenderingContext），如果 jsconfig.json 里没指定 "lib": ["es2017", "dom"]，很多 canvas、event 相关属性会标红或提示缺失——这不是 Babylon 的问题，是你 JS 配置漏了 DOM 支持。
