在 javascript es modules 中,默认导入使用 import 关键字配合花括号外的标识符来实现,语法为 import 名称 from '模块路径'。这种方式允许你给导出的默认值起一个任意名字,无需与导出时的文件名或函数名保持一致。如果模块同时包含默认导出和命名导出,可以通过 * 将所有命名导出收集到一个对象中,再结合点号访问来获取。

如何正确导入单个默认导出
当模块只导出一个默认值时,直接指定导入后的变量名即可。例如,在一个名为 utils.js 的文件中通过 export default function add() {} 定义了加法函数,在另一个文件中导入时,可以随意命名为 myAdd 或保持原名 add。这种灵活性是默认导入的主要优势,它解耦了导入端与导出端的命名依赖。
import myAdd from './utils.js'; console.log(myAdd(1, 2)); // 输出: 3
上述代码展示了最基础的用法。关键在于 from 后面的路径必须指向有效的模块文件(通常带 .js 后缀),且导入的标识符 myAdd 在当前作用域内必须是唯一的。如果尝试使用 import { default as myAdd } 也是合法的,但通常简写形式更常见。
如何处理混合导出场景
在实际项目中,模块往往既提供默认导出,又提供多个命名导出。此时需要分别处理。默认导出依然使用无花括号的语法,而命名导出则必须使用花括号包裹。你可以将两者写在同一行,也可以分开写。对于命名导出,导入的名称必须与导出时声明的名称完全一致,除非使用 as 关键字进行重命名。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
立即学习“Java免费学习笔记(深入)”;
// utils.js
export default function main() {}
export function helper() {}
// app.js
import main, { helper } from './utils.js';
main();
helper();这段代码演示了如何在一次导入操作中同时获取默认值和命名值。注意 main 没有花括号,而 helper 有花括号。如果忘记加花括号去导入命名导出,或者加了花括号去导入默认导出,都会导致运行时错误。此外,还可以使用 import * as Utils from './utils.js' 将所有命名导出收集到 Utils 对象中,然后通过 Utils.helper() 调用,但这不影响默认导出的单独导入。
默认导入在循环引用中会返回什么
当两个模块互相依赖并涉及默认导入时,JavaScript 引擎的处理机制与命名导入略有不同。ESM 规范规定,默认导出在模块加载初期会被初始化为 undefined,直到该模块的执行脚本运行完毕并执行到 export default 语句时,才会被赋予实际的值。因此,如果在模块 A 的顶层代码中直接导入模块 B 的默认导出,而模块 B 又在顶层导入了模块 A,那么模块 A 拿到的将是 undefined,而不是最终定义的函数或对象。
// moduleA.js
import { getValue } from './moduleB.js';
export default function getA() {
return getValue();
}
// moduleB.js
import getA from './moduleA.js';
export function getValue() {
return getA ? getA() : 'fallback';
}在上述示例中,moduleB.js 导入 getA 时,由于 moduleA.js 尚未执行完其默认导出的赋值过程,getA 的值为 undefined。因此 getValue() 会进入 else 分支返回 'fallback'。这种行为是 ESM 静态分析的特性决定的,旨在避免无限递归加载,开发者需意识到默认导出值的延迟绑定特性。

















