6. 常见问题

现象	检查方式
module "EUI" is not installed	导入路径是否指向完整 EUI/ 的父目录？目录里是否有 qmldir？
插件无法加载或提示 DLL 缺失	检查 Qt 版本、架构、编译器及 Debug/Release 一致；检查插件依赖和 Qt 运行库是否齐全
只复制了 QML，主题或工具不可用	复制完整构建产物，包含编译后的插件
cl、ninja 或 Qt 找不到	使用 Developer PowerShell，确认工具在 PATH 中，并修正 CMAKE_PREFIX_PATH
更新表格或树数组后 UI 不刷新	重新赋值一个新的 model 数组；避免只原地修改普通 JavaScript 数组
语言切换后业务文字未改变	ELocale 只管理内置文本；给业务 text / label 添加应用自己的翻译绑定
选择文件后未上传	默认不会自动发送；配置 action，调用上传方法或启用 autoUpload
EECharts 提示软件后端不可用	移除 QT_QUICK_BACKEND=software，确认宿主初始化、图形后端及 WebEngine 模块
品牌图标或视频无法显示	检查 SVG 插件或 Multimedia 后端及支持的媒体格式