require与import区别详解及选择指南

本篇文章向大家介绍《JavaScript中require和import的区别及如何选择》，主要包括，具有一定的参考价值，需要的朋友可以参考一下。

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 脚本。

基本上就这些。不复杂但容易忽略——关键是别强行统一，按环境和工具链自然选择更稳。

到这里，我们也就讲完了《require与import区别详解及选择指南》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！