常见故障排查

从构建到界面的错误速查

按现象缩小范围，再修改对应文件。

从构建到界面的错误速查
现象	检查与处理
找不到 KuiConfig.cmake	Kui_DIR 指向 SDK/cmake，不是 include 或 bin；确认解压完整。
LNK2019 / unresolved external	先确认导入 target 与 SDK 层一致，再查库架构、配置及缺少的 component。
找不到 DLL / 无法启动	对照 helper 输出检查目标目录；从该目录启动，核对同组运行时。
改了 HTML 没变化	嵌入式工程要重建生成头；确认运行的 EXE 路径，关闭旧实例。
输入能改但保存取旧值	读取控件当前 value()，不要读取初始 value 属性。
DevTools 连不上	启用目标窗口调试，保持消息轮询，重新发现端口和目标，排查旧会话认证。

空白页先检查文档是否加载、资源路径与节点是否存在。尺寸错误时在 DevTools 读取实际盒模型和 computed style，再检查选择器、固定宽度和滚动容器；不要同时改动整套样式。

控件存在但操作无效时，检查事件绑定是否执行、类型是否正确以及回调是否报错。Lua 再核对引擎创建、文档绑定、脚本执行和生命周期。通过断点观察当前值，不只看初始 HTML 属性。

附上系统架构、核心/绑定版本、构建配置、完整命令与错误文本。界面问题再提供最小 HTML/CSS、窗口尺寸、缩放、操作步骤、预期和实际结果。去掉私人数据、认证地址与令牌。

文档有误或遗漏？