Node.js中使用import()动态导入模块的错误排查与解决

问题场景 #

开发小型CLI应用时，需要根据启动参数-c/--colors（即argv.colors === true）来决定是否加载chalk模块——静态导入没问题，但动态导入时代码无报错却不生效，Node版本为v18.14.2。

错误尝试 #

一开始用import()配合async立即执行函数，写法类似这样：

(async () => {
  if (argv.colors) {
    import('chalk');
    // 这里调用chalk的代码完全没反应
  }
})();

既没报错，也看不到颜色输出，代码块等于没执行。

正确解决方式 #

问题出在没有正确获取chalk的默认导出，同时要确保awaitimport()返回的Promise。正确写法如下：

方式1：提前声明变量存储chalk实例

let chalk;
if (argv.colors) {
  // 解构获取default导出
  const { default: importedChalk } = await import('chalk');
  chalk = importedChalk;
}

// 后续使用示例
if (chalk) {
  console.log(chalk.blue('这是带颜色的输出'));
} else {
  console.log('这是普通输出');
}

方式2：在async IIFE内完整处理

(async () => {
  if (argv.colors) {
    const { default: chalk } = await import('chalk');
    console.log(chalk.green('颜色功能已生效'));
  } else {
    console.log('当前为无颜色模式');
  }
})();

原因说明 #

ES模块的import()会返回一个Promise，resolve后得到的对象包含模块的所有导出内容。而chalk模块主要通过默认导出暴露核心功能，之前的错误写法要么没await这个Promise（导致代码同步执行时chalk还没加载完成），要么没解构default属性（拿到的不是可用的chalk实例），所以才会出现代码不生效的情况。

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