如何从未安装的Node.js包中动态加载带依赖的JavaScript文件？

全局安装的CLI工具在目标模块目录执行时，使用相对路径import()报错找不到文件，核心原因是Node.js的模块解析根目录默认指向CLI的全局安装目录，而非用户执行命令的当前工作目录（即D盘的未安装模块目录）。以下是几种可行的解决思路：

方案1：使用绝对路径拼接动态导入 #

直接基于当前工作目录拼接目标文件的绝对路径，让import()能准确定位文件位置，同时Node会自动从目标目录的node_modules解析依赖。

const path = require('path');
const targetFilePath = path.resolve(process.cwd(), './dist/test/Test.js');

try {
  // 导入绝对路径指向的模块
  const testModule = await import(targetFilePath);
  // 调用模块导出的内容
  testModule.default?.run();
} catch (err) {
  console.error('模块加载失败:', err);
}

原理：process.cwd()获取用户执行CLI命令时的当前目录，path.resolve()将相对路径转换为系统可识别的绝对路径，彻底规避模块解析路径偏差问题。

方案2：创建基于目标目录的Require实例 #

利用Node.js的module.createRequire方法，生成一个以目标模块目录为根的require实例，通过它解析模块路径后再进行动态导入，确保依赖解析完全遵循目标目录的规则。

const path = require('path');
const { createRequire } = require('module');

// 以目标目录的package.json为基准创建require实例
const targetRequire = createRequire(path.resolve(process.cwd(), './package.json'));
// 解析目标模块的绝对路径
const targetModulePath = targetRequire.resolve('./dist/test/Test.js');

const testModule = await import(targetModulePath);

原理：createRequire绑定了目标目录的模块解析上下文，resolve方法会按照目标目录的node_modules和文件结构查找模块，完美适配目标项目的依赖环境。

方案3：通过子进程隔离加载环境 #

启动子进程在目标目录下执行模块加载脚本，完全复用目标目录的Node环境，通过IPC将模块导出内容传递给CLI主进程，隔离性更强。

const { spawn } = require('child_process');

// 子进程执行的模块加载脚本
const loaderScript = `
import path from 'path';
import { fileURLToPath } from 'url';
const __dirname = path.dirname(fileURLToPath(import.meta.url));
const targetModule = await import(path.resolve(__dirname, './dist/test/Test.js'));
process.send(targetModule.default);
process.exit();
`;

// 在当前工作目录启动子进程
const child = spawn('node', ['--input-type=module', '-e', loaderScript], {
  cwd: process.cwd(),
  stdio: ['inherit', 'inherit', 'inherit', 'ipc']
});

// 接收子进程传递的模块内容
child.on('message', (moduleExports) => {
  console.log('加载完成，模块导出内容:', moduleExports);
});

child.on('error', (err) => {
  console.error('子进程加载模块失败:', err);
});

原理：子进程的工作目录被设置为目标模块目录，模块解析完全遵循该目录的规则，不会受到CLI自身全局环境的干扰，适合复杂依赖场景。

方案4：自定义模块解析钩子（Node.js 18+） #

通过Node.js的实验性加载器（Loader）修改模块解析逻辑，将相对路径重定向到当前工作目录，无需手动拼接路径。

首先创建自定义加载器文件custom-loader.js：

import { resolve as resolvePath } from 'path';
import { fileURLToPath } from 'url';

export async function resolve(specifier, context, defaultResolve) {
  // 处理相对路径，解析到当前工作目录
  if (specifier.startsWith('./') || specifier.startsWith('../')) {
    const absolutePath = resolvePath(process.cwd(), specifier);
    const moduleUrl = new URL(`file://${absolutePath}`);
    return defaultResolve(moduleUrl.href, context, defaultResolve);
  }
  // 非相对路径沿用默认解析逻辑
  return defaultResolve(specifier, context, defaultResolve);
}

然后在CLI启动命令中添加加载器参数：

node --experimental-loader ./custom-loader.js your-cli-entry.js

注意：该方案依赖Node.js的实验性特性，版本兼容性需留意，适合需要高度自定义解析规则的场景。

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