require是CommonJS运行时动态加载,import是ESM编译时静态解析;二者不可混用,选择取决于环境、工具链和项目规范。
require 是 CommonJS 模块系统的语法,运行时动态加载;import 是 ES 模块(ESM)的标准语法,编译时静态解析。两者不能混用(除非借助工具转换),选择主要看运行环境、打包工具和项目规范。
模块系统背景不同
require 来自 Node.js 早期采用的 CommonJS 规范,每个文件是一个模块,通过 module.exports 导出、require() 导入,支持动态路径和条件加载。
import/export 是 ECMAScript 官方标准(ES2015 起),设计为静态结构——语句必须在顶层、不能放在 if 或函数内,便于 Tree-shaking 和编译优化。
加载时机与执行方式不同
require 是同步执行的,调用时才去读取、解析、执行模块代码,可写成 require(somePath + '.js') 这类动态形式。
import 必须在模块顶部声明,浏览器和现代 Node.js(需 .mjs 或 type="module")会先解析所有 import 语句,构建依赖图,再统一执行——因此不支持运行时拼接路径。
- ✅ import { foo } from './utils.js' —— 合法
- ❌ if (x) import { bar } from './other.js' —— 语法错误
- ✅ const mod = await import('./dynamic.js') —— 动态导入(返回 Promise),是 import 的补充,不是 require 替代品
Node.js 中的实际使用差异
Node.js 从 v12 起支持 ESM,但默认仍是 CommonJS(.js 文件)。启用 ESM 需满足以下任一条件:
- 文件扩展名为 .mjs
- package.json 中设置 "type": "module"
- 启动时加 --input-type=module 参数(仅限字符串输入)
注意:一个包不能同时用 require 和 import 加载同一模块(会报错),且 require 无法直接加载 ESM 模块(反之亦然),需靠 createRequire 或顶层 await 等方式桥接。
如何选择?看场景
选 import:新项目、浏览器环境、用 Vite/Webpack/Rollup 等现代打包工具、需要按需加载或代码分割、重视静态分析(如类型检查、压缩优化)。
选 require:纯 Node.js 脚本(尤其老版本)、需动态构造模块路径、
兼容性要求高(如要跑在 Node.js v10)、或维护遗留 CommonJS 项目。
混合项目中,可用 动态 import() 处理运行时逻辑,替代大部分 require 的动态需求;而配置层(如 webpack.config.js)仍常用 require,因它本身是 Node.js 环境执行的 CommonJS 脚本。
基本上就这些。不复杂但容易忽略——关键是别强行统一,按环境和工具链自然选择更稳。








