Node.js中不支持require和import两种导入模块的混用

最近在整理Node.js相关的知识点，发现通过Node.js支持的两个模块导入语句require和import在同时使用时会发生错误，而且错误非常诡异。

例如，在先使用require导入模块，在使用import导入模块时，出现require无法识别，

在先使用import导入模块，在使用require导入模块时，同样出现了require无法识别，建议使用import代替。

javascript 复制代码

ReferenceError: require is not defined in ES module scope, you can use import instead

javascript 复制代码

const readFile = require('fs').readFile;
                 ^

ReferenceError: require is not defined in ES module scope, you can use import instead
    at file:///d:/Software/Electron/JavaScript/LearnProject/NodeJsProject/BasicModules/FileOperation.js:10:18
    at ModuleJob.run (node:internal/modules/esm/module_job:271:25)
    at async onImport.tracePromise.__proto__ (node:internal/modules/esm/loader:547:26)
    at async asyncRunEntryPointWithESMLoader (node:internal/modules/run_main:116:5)

Node.js v22.13.1

javascript 复制代码

'use strict'
//const {randomInt} = require('node:crypto');
import {randomInt} from 'node:crypto';
const n = randomInt(0,100);
console.log('BasicModules.js: randomInt:', n);



//import {readFile} from 'node:fs';
const readFile = require('fs').readFile;
console.log("BasicModules.js: readFile start");

readFile('BasicModules.js', 'utf-8', (err, data)=>{
    if (err) {
        console.log('BasicModules.js: readFile error:', err);
    } else {
        console.log('BasicModules.js: readFile data:', data);
    }
});

console.log("BasicModules.js: readFile End");

Node.js 中无法同时使用 require 和 import 的根本原因在于两种模块系统的设计差异。以下是具体原因和解决方案的总结：

模块系统差异

CommonJS（require）
Node.js 原生支持的模块系统，同步加载模块，适用于服务端开发。
通过 module.exports 导出，require() 导入，本质是运行时加载。
ES 模块（import/export）
官方标准化模块系统，异步加载，支持静态分析，适用于浏览器和现代 Node.js 环境。
通过 export 导出，import 导入，编译时确定依赖关系。

报错原因分析

当文件被识别为 ES 模块时（文件中使用了import就会自动识别为ES模块）：

Node.js 默认禁用 require ，因为 ES 模块设计上要求代码静态化，而 require 是动态的 $\[1$ $3$ 6。

错误 ReferenceError: require is not defined in ES module scope 表明当前文件被识别为 ES 模块，但尝试使用了 CommonJS 语法。

1. 解决方案

1.1 统一模块类型

方法一：显式声明模块类型

在 package.json 中添加 "type": "module"，所有 .js 文件默认视为 ES 模块；使用 .cjs 扩展名表示 CommonJS 模块。

方法二：动态兼容

在 ES 模块中通过 createRequire 引入 require：

javascript 复制代码

import { createRequire } from 'module';
const require = createRequire(import.meta.url); 
// 之后可使用 require()

此方式允许在 ES 模块中局部使用 CommonJS 语法 $\[1$ $7$ 10。

1.2 模块互操作

导入 CommonJS 模块到 ES 模块

使用 import 导入时，CommonJS 模块会被包装为默认导出：

javascript 复制代码

import fs from 'fs';  // 等同于 require('fs').default

导入 ES 模块到 CommonJS

需使用动态 import()：

javascript 复制代码

const loadModule = async () => {
  const esModule = await import('./es-module.mjs'); 
};

1.3 环境配置

Node.js 版本要求

确保版本 ≥ 14，并启用实验性 ES 模块支持（旧版本需添加 --experimental-modules 标志）。

文件扩展名

ES 模块建议使用 .mjs，CommonJS 使用 .cjs，避免解析歧义。

2. 最佳实践

项目级统一规范

新项目优先使用 ES 模块，老项目逐步迁移，避免混用。

工具链适配

使用 Babel 或 TypeScript 编译代码，兼容不同模块系统。

3. 总结

Node.js 中 require 和 import 的冲突源于模块系统的底层差异。通过统一模块类型、动态兼容或工具链适配，可解决这一问题。建议根据项目需求选择合适的模块方案，并遵循 Node.js 官方文档的模块互操作指南。