Node.js动态导入模块的依赖解析问题咨询

问题原因 #

Node的ES模块（.mjs）解析包依赖时，是从被导入模块的目录开始向上递归查找node_modules——不管是静态导入还是动态导入，都遵循这个规则。你的helper.mjs在C:\Users\don\scripts\目录下，该目录及上层目录都没有mmmagic包，而主应用的node_modules在其他路径，因此Node无法找到依赖。

解决方法 #

方法1：用createRequire替代动态导入（最稳定） #

CommonJS的require会基于当前进程的工作目录（主应用目录）查找node_modules，可以借助createRequire把ES模块的动态导入转成CommonJS风格加载，复用主应用的依赖树：

import { createRequire } from 'node:module';
// 基于主应用模块路径创建require函数
const require = createRequire(import.meta.url);
// 加载helper.mjs，此时其内部静态导入会使用主应用的node_modules
const helper = require('./scripts/helper.mjs');

方法2：设置环境变量并启用实验性解析规则 #

如果坚持用ES模块的动态导入，可通过NODE_PATH指定主应用的node_modules路径，同时让Node用CommonJS的解析规则处理ES模块：

1. 启动Node时配置环境变量和参数：

NODE_PATH=./node_modules node --experimental-specifier-resolution=node

2. 在REPL中执行动态导入：

await import('./scripts/helper.mjs');

方法3：动态导入时指定自定义解析路径（Node 18+ 实验性） #

Node 18及以上支持在动态导入时通过paths选项指定依赖查找路径，直接指向主应用的node_modules：

await import('./scripts/helper.mjs', {
  paths: [process.cwd() + '/node_modules']
});

注意：该特性为实验性，后续可能有变动，需确保Node版本符合要求。

方法4：给动态模块目录添加package.json并链接依赖（合规但繁琐） #

在C:\Users\don\scripts\目录下创建package.json，再将主应用的mmmagic链接到该目录：

1. 创建package.json：

{
  "name": "scripts",
  "type": "module"
}

2. 主应用目录执行：

npm link mmmagic

3. 进入scripts目录执行：

npm link mmmagic

此时Node会从scripts目录的链接找到主应用的mmmagic包。

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