You need to enable JavaScript to run this app. 如何在无模块打包器的Typescript项目中使用ThreeJS ES6原生模块
优惠活动
大模型
产品
解决方案
定价
更多

如何在无模块打包器的Typescript项目中使用ThreeJS ES6原生模块

解决步骤

你遇到的是TS类型定义路径和浏览器原生ES模块路径规则的冲突问题,按照以下步骤操作即可在无打包器的场景下正常使用:

方案1:保留原有相对路径导入写法(无需修改HTML)

如果你不想改动原来JS项目的导入逻辑,直接做两步配置即可:

  1. 在项目根目录新建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';
}
  1. 确认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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.19 03:36:04