You need to enable JavaScript to run this app. 使用@react-three/fiber与@react-three/drei时出现Three.js重复导入警告
优惠活动
大模型
产品
解决方案
定价
更多

使用@react-three/fiber与@react-three/drei时出现Three.js重复导入警告

开发环境触发Three重复导入警告的原因
  • 这是CRA开发环境模块解析规则、旧版本依赖嵌套逻辑共同导致的现象,和生产构建的行为差异来自两端的打包配置目标不同:
    • 开发模式下Webpack为了保障热更新(HMR)的响应速度,不会对node_modules下的嵌套路径模块做严格的跨目录去重,只要不同依赖的引用路径能被解析到Three.js文件,就会单独加载对应实例,不会强制合并到全局唯一模块。
    • 你当前使用的是2021年的版本序列:当时npm对peer依赖的自动提升(hoist)逻辑还不健全,@react-three/drei@4.2.0内部会声明对Three的版本依赖,开发环境解析时如果出现根目录安装的three、drei嵌套目录下的three两个可解析路径,就会触发Multiple instances的警告。
  • 生产构建不会出现这个问题的原因:生产模式下Webpack会开启完整的模块去重规则,通过resolve配置、代码压缩阶段的重复片段合并,把所有路径引用的同版本Three代码合并到同一个chunk中,不会拆分出多个独立的Three实例,所以打包分析时看不到重复的three.module.js条目。
可落地的排查解决方式
  • 不需要执行复杂的eject操作,只要在项目的Webpack解析配置里强制给three设置别名,指向项目根目录node_modules下安装的唯一Three实例,让所有嵌套依赖引用Three时都加载同一个文件,就能彻底消除这个警告。
  • 可以在安装依赖时锁定版本,避免npm浮动版本号导致的嵌套重复安装:去掉版本号前的^符号,在package.json里把三个依赖的版本固定为匹配的兼容区间,重新执行安装即可让npm把Three依赖提升到根目录,消除嵌套路径的重复安装问题。
  • 额外说明:经过生产构建验证不存在重复Three实例的前提下,这个警告仅为开发环境的提示,不会引发生成环境的运行bug(比如渲染上下文不匹配、材质实例冲突这类问题)。

内容的提问来源于stack exchange,提问作者sxkx

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.24 01:36:03