You need to enable JavaScript to run this app. 如何在Node.js环境中使用d3.js,解决require引入失败、import依赖冲突问题?
优惠活动
大模型
产品
解决方案
定价
更多

如何在Node.js环境中使用d3.js,解决require引入失败、import依赖冲突问题?

问题核心原因

D3 v7及以上版本已转为纯ES模块,不再支持CommonJS规范的require()直接同步导入,是require引入失败的根本原因。

解决方案

  • 方案1:使用动态import()适配现有CommonJS项目
    无需修改项目整体模块规范,不会和其他依赖CommonJS的库冲突,仅需调整d3加载逻辑为异步即可,同时你原有代码中的jsdom.jsdom()是jsdom v10之前的旧API,新版jsdom需同步调整为JSDOM构造函数写法,示例如下:
const jsdom = require("jsdom");
const { JSDOM } = jsdom;

(async () => {
  // 异步加载ES模块格式的d3
  const d3 = await import("d3");
  const document = new JSDOM().window.document;
  const svg = d3.select(document.body).append("svg");
  // 后续所有d3相关逻辑都写在当前异步作用域内即可
})();
  • 方案2:降级D3到兼容CommonJS的版本
    如果不想改动现有代码逻辑,直接安装D3 v6版本即可,该版本原生支持直接require()引入,执行安装命令:
    npm install d3@6
    安装完成后你原来的代码可以直接正常运行,无需其他修改。

  • 方案3:文件级区分模块规范
    如果不排斥使用import语法,仅担心全局规范冲突,可以将用到D3的文件后缀修改为.mjs,在该文件内用import引入D3,其余.js文件保持原有CommonJS规范即可,两种模块规范在Node.js环境下可共存,不会互相冲突。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.16 00:54:01