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

最近在整理Node.js相关的知识点，发现通过Node.js支持的两个模块导入语句require和import在同时使用时会发生错误，而且错误非常诡异。 例如，在先使用require导入模块，在使用import导入模块时，出现require无法识别， 在先使用import导入模块，在使用require导入模块时，同样出现了require无法识别，建议使用import代替。

ReferenceError: require is not defined in ES module scope, you can use import instead 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 '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：

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

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

1.2 模块互操作

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

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

导入 ES 模块到 CommonJS 需使用动态 import()：

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 官方文档的模块互操作指南。