yaml解析需选libyaml或yaml-cpp：libyaml轻量但需手动建树，yaml-cpp易用但0.8+才支持锚点且须禁用abi检查；类型映射须显式校验，ui动态构建须严守qt线程、对象树与生命周期约束。
YAML解析必须选对库：libyaml vs yaml-cpp 的实际取舍
直接读取YAML后“反射式”生成UI，核心前提是YAML结构能被稳定映射为C++类型——这一步就卡死在解析器选择上。libyaml是C接口、零内存管理抽象，yaml-cpp提供C++风格API但默认不支持锚点/别名的深层拷贝，且Node::IsMap()等判断在空节点时可能抛std::runtime_error而非返回false。
- 若配置含锚点（
&common）或复杂合并（），必须用<code>yaml-cpp 0.8+并启用YAML_CPP_DISABLE_ABI_BREAKING_CHECKS编译宏，否则运行时崩溃 -
libyaml适合嵌入式或需严格控制内存分配的场景，但你要自己写事件驱动状态机来建树，无法直接“node["ui"]["buttons"][0]["label"]”这种访问 - 别信文档里“自动类型推导”——
yaml-cpp把123和"123"都当ScalarNode，as<int>()</int>对字符串会静默转0，得先用IsScalar()+IsInteger()双检
从YAML节点到C++对象：绕不开的类型擦除与手动dispatch
C++没有运行时类型信息（RTTI）支撑真正的反射，所谓“动态生成UI”，本质是按YAML字段名硬编码分支逻辑。比如type: "button" → 创建QPushButton*，type: "slider" → 创建QSlider*，中间没有通用转换层。
- 别试图用
std::any或boost::variant统一存所有控件指针——Qt对象必须由QObject派生，且父子关系依赖QObject构造函数传入parent，std::any无法满足生命周期约束 - 每个UI组件类型必须显式注册工厂函数，例如：
factory_map["button"] = []{ return new QPushButton(); };，YAML里多一个type: "toggle_button"就得补一条注册，漏了就std::bad_function_call -
yaml-cpp的Node不可拷贝，传参务必用const YAML::Node&，否则临时Node析构后内部引用失效，后续as<string>()</string>返回乱码
Qt UI动态构建时最常崩的三个点
YAML解析成功不等于UI能活过第一帧。Qt的线程亲和性、对象树管理和属性绑定机制，在动态场景下极易触发未定义行为。
- 所有UI创建必须在主线程（
QApplication::instance()->thread()），YAML解析可在工作线程，但new QPushButton()这一行必须QMetaObject::invokeMethod(..., Qt::BlockingQueuedConnection)切回来，否则QWidget: Must construct a QApplication before a QWidget - YAML中
parent: "main_window"这类字段不能直接findChild<qwidget>("main_window")</qwidget>——Qt对象名（objectName）默认为空，必须提前用setObjectName("main_window")显式设置，否则返回nullptr导致new出来的控件没父对象，窗口关闭时内存泄漏 - 绑定信号时，
connect(btn, &QPushButton::clicked, this, &MyClass::onClicked)里的this必须是存活的QObject，如果这个this是栈对象或已析构，程序立即终止，无任何错误提示
为什么“模拟反射”比真反射更难维护
真正麻烦的不是写一次，而是改一次配置就要同步改三处：YAML schema、工厂注册、属性赋值逻辑。比如加个icon_path字段，你得改：
- YAML示例文件里补一行
icon_path: ":/icons/save.svg" - 在按钮工厂里加
if (node["icon_path"]) btn->setIcon(QIcon(node["icon_path"].as<string>()));</string> - 还得检查
QIcon构造是否失败——QIcon(":/xxx").isNull()为true时不会报错，但按钮图标空白，用户以为配置错了
这种耦合藏得深，静态分析工具扫不出来，只有当某个路径拼错、某个字段名大小写不一致、或者YAML缩进用的是tab而非空格时，才会在运行时某次点击后突然黑屏或闪退。调试时得同时盯住YAML解析日志、Qt消息处理器、以及qInstallMessageHandler捕获的qWarning，缺一不可。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
