Skip to content

编译诊断

@elfui/vite-plugin 会对宏组件给出构建期诊断。

场景处理
导入宏 API 但没有导出 defineHtml()补组件导出或删除宏导入
使用已移除宏别名改为 defineProps / defineEmits 等新 API
pragma 位置不合法移到文件顶部或改用普通 .ts 导出

Vite 启动阶段还会检查 Core、Compiler 与 Vite Plugin 的精确 beta 版本和编译协议。错配会以 ELF_VITE_VERSION_MISMATCHELF_VITE_PROTOCOL_MISMATCH 在第一次模板编译前停止,并显示实际解析路径、修复命令和 Vite cache 清理提示。

严格模式

ts
elfuiMacroPlugin({
  strictDiagnostics: true,
  templateTypeCheck: true,
});

strictDiagnostics 适合 CI;templateTypeCheck 适合组件库和 beta 前质量门禁。