在 javascript es modules 中,相对路径导入必须显式包含文件扩展名(如 .js),且路径以 . 或 .. 开头。浏览器环境严格遵循此规范,node.js 环境从 v14+ 起也默认要求扩展名,否则可能因解析失败导致模块加载错误。

为什么不能省略 .js 扩展名?
省略扩展名会导致模块解析器无法定位实际文件,从而抛出 ERR_MODULE_NOT_FOUND 或类似错误。这是因为 ES Modules 规范将扩展名视为路径的一部分,而非自动补全的元数据。开发者常误以为 Node.js 的 CommonJS 行为(自动查找 .js、.json 等)适用于 ESM,但两者解析机制不同。ESM 要求路径精确匹配文件系统上的文件名,包括扩展名。

import { helper } from './utils.js';
console.log(helper()); // 正确:明确指定 .js
// import { helper } from './utils'; // 错误:缺少扩展名,浏览器和 Node.js ESM 均会失败
上述代码展示了正确的导入方式。若省略 .js,浏览器控制台会显示 Failed to resolve module specifier "./utils",Node.js 则抛出 Error [ERR_MODULE_NOT_FOUND]。务必确保导入路径与磁盘文件名完全一致,包括大小写和扩展名。
如何处理目录索引文件 index.js?
当导入目录时,需显式指定 index.js,例如 import { func } from './lib/index.js'。虽然某些工具链(如 Webpack)支持隐式解析 index.js,但原生 ES Modules 不支持此行为。直接导入目录而不带文件名会触发解析错误,因为服务器未配置自动返回索引文件。开发者应始终使用完整路径,避免依赖构建工具的隐式规则。

// 假设 lib/ 目录下有 index.js
import { func } from './lib/index.js'; // 正确:显式指定 index.js
// import { func } from './lib'; // 错误:原生 ESM 不支持目录隐式解析
此代码验证了目录导入的正确做法。若尝试 import ... from './lib',Node.js 会报错 ERR_MODULE_NOT_FOUND,浏览器同样拒绝加载。保持路径显式化可确保跨环境兼容性,无需额外配置即可工作。
动态导入时相对路径如何拼接?
动态导入 import() 同样要求相对路径包含扩展名,且路径字符串需基于当前模块位置计算。例如,import('./module.js') 中的 ./ 表示相对于当前文件的目录。若路径拼接错误(如遗漏 .js),运行时将抛出模块未找到异常。开发者应使用模板字符串或路径处理库确保扩展名存在,避免硬编码错误。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











