为何QCheckBox::stateChanged信号传递int而非Qt::CheckState枚举类型？

Qt定义了枚举类型Qt::CheckState，这个类型被QCheckBox::checkState()和QCheckBox::setCheckState()等方法直接使用。但让人困惑的是，QCheckBox::stateChanged信号的参数被定义为int而非Qt::CheckState——这导致我们连接该信号的槽函数时，丢失了枚举本身的语义，不仅使用起来麻烦，还让Qt::CheckState显得有些“鸡肋”。

请问这种设计决策背后有合理逻辑吗？还是属于Qt的设计失误？

设计逻辑：历史兼容性与早期MOC限制 #

这并非设计失误，而是Qt为了历史兼容性和适配早期元对象编译器（MOC）的限制做出的选择：

• 早期MOC对枚举的支持不足
  在Qt 4及更早版本中，MOC对命名空间内的枚举类型处理存在局限，无法正确识别Qt::CheckState作为信号参数的类型信息。使用int作为参数可以绕过这个问题，确保信号槽机制能正常工作。

• 向后兼容的保守策略
  即使后续Qt版本的MOC已经完全支持枚举类型作为信号参数，Qt团队也不会轻易修改这类核心API的参数类型——因为这会导致大量依赖旧代码的项目编译失败。保持int参数可以确保所有基于旧版本Qt编写的代码在新版本中仍能正常运行。

• 信号槽匹配的灵活性
  早期Qt的信号槽匹配是基于字符串的类型匹配，使用int作为参数能提供更高的灵活性：槽函数既可以接收int类型，也可以在显式转换后接收Qt::CheckState类型；反之如果信号参数是枚举类型，旧的槽函数（用int接收）会直接匹配失败。

规避语义丢失的实用方法 #

虽然参数是int，但你可以通过以下方式恢复枚举语义：

1. 在槽函数中显式转换类型：

void onCheckStateChanged(int state) {
    Qt::CheckState checkState = static_cast<Qt::CheckState>(state);
    // 后续使用checkState处理逻辑
}

2. 在Qt 5及以上版本中，利用基于函数指针的新信号槽语法，让编译器自动完成类型校验：

connect(checkBox, &QCheckBox::stateChanged, this, [](Qt::CheckState state) {
    // 直接使用Qt::CheckState类型参数
});

内容的提问来源于stack exchange，提问作者Fareanor