为什么Node在使用es module时必须加上文件扩展名?
参考答案
原因
ESM 是静态模块规范,import 的路径在解析阶段就要被确定为一个明确的资源,因此不做 CJS 那套"猜测式补全":
- 不自动补
.js/.mjs - 不把目录当成
index.js - 不做
package.json的main回退
规范层面
ES Module 的说明符(module specifier)遵循 URL 语义,浏览器里 ./a 就是一条 HTTP 请求路径,服务端不会替你补扩展名。Node 为保持"同一份代码在浏览器和 Node 行为一致",选择了严格解析。
CJS 为什么可以省
require 是运行时同步函数,内部有一套完整算法:先按路径找,再依次尝试 .js、.json、.node,再查目录的 package.json main、最后 index.*,所以 require('./a') 能命中 a.js。
例外与实践
- 包名导入(
import x from 'lodash')仍然会走node_modules与exports字段解析,不需要扩展名。 - 想省扩展名:用打包工具(Vite/webpack)、
tsconfig的moduleResolution: bundler、或 Node 的--experimental-specifier-resolution=node(已弱化/移除)。 - 更推荐用
exports字段显式声明入口,而不是依赖隐式补全。