模块导出为undefined的根本原因是导出值未初始化或导出导入方式不匹配。需检查ESM绑定时机、确保导出已赋值或用函数封装，严格对应export/import语法，排查构建干扰，并实测导入值。
模块导出时出现 undefined，通常不是“没写导出”，而是导出时机、初始化顺序或导出方式与消费方式不匹配所致。关键不在“有没有”，而在“有没有准备好”。
检查导出值是否已初始化
ESM 模块在解析阶段就确定导出绑定，但实际值可能尚未计算完成——尤其当导出依赖异步操作、条件逻辑或顶层 await 时。
- 避免直接导出未初始化的变量：
export let config;→ 后续赋值前被导入，拿到的就是undefined - 优先导出已赋值的常量：
export const API_BASE = 'https://api.example.com'; - 若需运行时计算，用函数封装：
export function getApiConfig() { return window.APP_CONFIG ?? defaultConfig; }
确认导出语法与导入方式一致
导出和导入必须严格对应，否则导入结果为 undefined（而非报错）。
-
export default function foo() {}→ 必须用import foo from './module.js'，不能写成import { foo } from './module.js' -
export const bar = 42;→ 只能用import { bar } from './module.js'，import bar from './module.js'会得到undefined - 动态
import()返回 Promise，解构前务必await：const { helper } = await import('./utils.js');
排查构建与加载干扰
打包工具（如 Webpack/Vite）或压缩（如 Terser）可能重命名、摇树或提前执行模块，导致导出值被误判为 undefined。
立即学习“Java免费学习笔记（深入）”；
- 检查构建产物中目标模块是否真实存在且导出项未被移除（查看
dist下对应文件） - 禁用压缩后测试：临时关闭
terserOptions或设minify: false，观察问题是否消失 - 确认
type="module"脚本标签已正确声明，避免浏览器以传统脚本方式加载 ESM
验证导入端的实际值
不要只看代码，要实测导入结果。
- 在导入模块顶部加
console.log(importedValue)或debugger - 在控制台直接输入导入名（如
foo），看返回的是函数体、对象，还是undefined - 用
typeof importedValue === 'undefined'判断，比importedValue == null更精准（避免误判null）
