addItem()最快但需注意参数顺序和QVariant类型安全；复杂数据用QStandardItemModel+setData()；addItems()不支持userData；多选需自定义控件或委托。
直接用 addItem() 最快，但要注意参数顺序和数据类型
绝大多数场景下，addItem() 就够用了。它接受两个参数：text（显示文本）和可选的 userData（绑定的任意数据）。注意：第二个参数是 QVariant 类型，不是裸指针或自定义结构体——传入结构体需先用 QVariant::fromValue 封装。
常见错误现象：传入 new MyData() 导致崩溃；或传入 int* 后在槽函数里解引用失败。这是因为 QVariant 不管理原始指针生命周期。
comboBox->addItem("选项1", QVariant::fromValue(config)); comboBox->addItem("选项2", 1001); // int 自动转为 QVariant- 避免：
comboBox->addItem("选项3", new QString("bad")); // 内存泄漏+类型不匹配
要绑定复杂对象，必须用 QStandardItemModel + setItemData()
当每个选项需要同时携带图标、ID、状态标志、甚至完整对象实例时，addItem() 的 userData 就不够用了。这时候得换模型层操作。
核心是：创建 QStandardItem → 调用 setData() 往不同 role 写数据 → 把 item 加进 QStandardItemModel → 再把 model 绑给 QComboBox。
-
Qt::DisplayRole存显示文本（必填） -
Qt::DecorationRole存QIcon（可选） -
Qt::UserRole及更高偏移量存自定义数据，比如Qt::UserRole+1存 ID，Qt::UserRole+2存配置结构体 - 获取时用
model->item(index)->data(Qt::UserRole+1)，再调.value()
批量添加用 addItems()，但无法带 userData
addItems(const QStringList &texts) 只能填文本列表，所有项共用一个空 QVariant() 的 userData。如果后续想按索引查对应数据，就得自己维护一个平行数组或 map，容易错位。
更安全的做法是：循环调用 addItem()，或者统一走 QStandardItemModel 流程。尤其当数据来自数据库或 JSON 解析结果时，别图省事用 addItems() 后再补数据——时机不对会触发多余信号，UI 显示异常。
自定义多选下拉框不能靠 addItem() 实现勾选逻辑
原生 QComboBox 的 addItem() 和模型机制，完全不处理复选框状态。即使你强行往 QStandardItemModel 里设了 Qt::CheckStateRole，点击也不会响应——因为默认委托没重写 editorEvent()，也不拦截鼠标事件。
真正可行的路径只有两条：
- 继承
QComboBox，替换view()为自定义QListWidget，每个 item 套QCheckBox，手动连信号更新显示（见MultiSelectComboBox示例） - 用
QStyledItemDelegate自绘复选框，并重写editorEvent()处理点击、空格键等，同步模型中的CheckStateRole
别试图在 addItem() 后调 setModel() 混搭——Qt 的内部状态机不认这种组合，下拉弹出后 checkbox 点击无反馈是常态。
