如何在无模块打包器的Typescript项目中使用ThreeJS ES6原生模块
解决步骤
你遇到的是TS类型定义路径和浏览器原生ES模块路径规则的冲突问题,按照以下步骤操作即可在无打包器的场景下正常使用:
方案1:保留原有相对路径导入写法(无需修改HTML)
如果你不想改动原来JS项目的导入逻辑,直接做两步配置即可:
- 在项目根目录新建
global.d.ts类型声明文件,写入以下内容:
// 关联本地three文件和官方类型定义 declare module './lib/three.module.js' { export * from 'three'; } declare module './lib/OrbitControls.js' { export * from 'three/examples/jsm/controls/OrbitControls'; }
- 确认
tsconfig.json包含以下基础配置:
{ "compilerOptions": { "target": "ES2020", "module": "ESNext", "moduleResolution": "Bundler", "skipLibCheck": true, "allowSyntheticDefaultImports": true } }
配置完成后你可以继续使用原来的导入语句,TS会自动匹配类型,编译后的代码路径和之前完全一致,浏览器可以直接运行:
import * as THREE from './lib/three.module.js' import { OrbitControls } from './lib/OrbitControls.js'
方案2:使用裸导入写法(更简洁,依赖浏览器Import Map)
如果你想使用import * as THREE from 'three'的简洁写法,不需要修改TS的导入语句,只需要在HTML入口文件的<head>中添加原生Import Map配置,让浏览器自动映射裸导入到本地文件路径即可:
<script type="importmap"> { "imports": { "three": "./lib/three.module.js", "three/examples/jsm/": "./lib/" } } </script>
同时在tsconfig.json中添加路径映射配置,让TS可以匹配到对应类型:
{ "compilerOptions": { // 其余基础配置和方案1一致 "paths": { "three": ["./lib/three.module.js"], "three/examples/jsm/*": ["./lib/*"] } } }
两种方案都不需要任何模块打包器,编译后的代码可以直接在支持ES模块的浏览器中运行。
内容的提问来源于stack exchange,提问作者Kokodoko
相关产品推荐
相关产品推荐

