无NPM环境下TypeScript引入Three.js：智能提示失效与编译卡顿问题

• 当前paths配置直接指向Three.js的JS模块文件，TypeScript默认不会自动解析JS文件的类型信息，因此VS Code无法提供智能提示。
• 开启allowJs: true后，TypeScript会扫描项目内所有JS文件，包括Three.js体积庞大的源码，这会大幅增加编译负担，导致速度变慢甚至编译器崩溃。

1. 单独引入Three.js类型定义文件 #

下载对应0.157.0版本的Three.js官方类型定义文件（通常是three.d.ts），将其放到./Scripts/three-0.157.0/目录下。

修改tsconfig.json的paths配置，让TypeScript优先读取类型定义文件：

"paths": {
  "three": ["./Scripts/three-0.157.0/three.d.ts", "./Scripts/three-0.157.0/three.module.js"],
  "three/addons/*": ["./Scripts/three-0.157.0/jsm/*"]
}

同时保持compilerOptions中的allowJs为false，避免编译时处理大量JS文件。

2. 优化类型扫描（可选） #

如果类型文件未被自动识别，在compilerOptions中添加typeRoots指定类型文件目录：

"typeRoots": ["./Scripts/three-0.157.0"]

或者直接指定要加载的类型：

"types": ["three"]

这能帮助TypeScript更快定位到类型定义，提升提示响应速度。

3. 验证效果 #

修改完成后，VS Code会通过three.d.ts获取完整类型信息，智能提示恢复正常；同时因allowJs关闭，编译仅处理TS文件，效率不受影响。

内容的提问来源于stack exchange，提问作者munHunger