1. 项目概述：用QLabel打造一个工业级的指示灯系统

在工业上位机、设备监控或者任何需要直观状态反馈的桌面软件里，指示灯（Status LED）是个再常见不过的组件了。无论是PLC通讯状态、设备运行模式，还是烘箱的烘烤阶段，一个小小的、会变色的灯，其信息传递效率远胜于一段冰冷的文字。很多刚接触Qt的朋友，可能会四处寻找专门的“指示灯”控件，或者琢磨着用QPushButton来模拟。其实，大可不必这么麻烦。Qt自带的QLabel，这个看似只能显示文本和图片的“老实人”，经过一番调教，完全能变身为一套灵活、高效且美观的指示灯系统。今天，我就结合一个典型的工业控制场景——多配方烘箱控制，来详细拆解如何用QLabel实现红绿灯式的状态指示灯，并融入闪烁、复位等高级功能。你会发现，用QLabel来做这件事，不仅代码简洁，而且性能开销小，维护起来也特别直观。

2. 核心思路与方案选型：为什么是QLabel？

在动手之前，我们先聊聊为什么选择QLabel，而不是其他控件。这背后是对于控件特性和应用场景的深度考量。

2.1 QLabel的天然优势

首先，QLabel的核心功能是显示内容，无论是文本（setText）还是图片（setPixmap）。对于指示灯而言，我们本质上就是在显示不同颜色、不同形状的“图片”。QLabel对此提供了最直接的支持。

其次，QLabel轻量。它不像QPushButton那样内置了复杂的交互逻辑（点击、按压状态、快捷键等），也不像QWidget需要我们自己处理绘制事件（paintEvent）。在只需要“显示”功能的场景下，使用QLabel意味着更少的内存占用和更纯粹的逻辑。

再者，QLabel样式化（Styling）非常方便。通过Qt的样式表（QSS），我们可以像定义CSS一样，轻松地修改QLabel的背景色、边框、圆角，从而创造出圆形、方形、带光晕等各种样式的指示灯，而无需动用任何绘图代码。这对于快速原型开发和UI美化至关重要。

2.2 对比其他方案

• QPushButton：可以通过设置setCheckable(true)和样式表来模拟指示灯。但它的“可点击”属性是多余的，可能会引起误操作（虽然可以禁用），在语义上也不够纯粹。代码中会多出一些与“按钮”相关的状态管理。
• 自定义QWidget：重写paintEvent方法，自己用QPainter画圆。这种方式最灵活，可以实现任何炫酷的效果，但代价是代码量最大，需要处理缩放、高DPI适配等细节，对于简单的指示灯来说有点“杀鸡用牛刀”。
• 第三方控件库：如QtitanRibbon、QWT等可能包含LED控件。但这会引入额外的依赖，增加项目复杂度和发布难度。

所以，综合来看，使用“QLabel + QSS样式表”是实现指示灯功能在效率、简洁性和灵活性上最平衡的方案。它完美契合了KISS（Keep It Simple, Stupid）原则。

2.3 烘箱控制场景映射

让我们把思路套用到输入信息提到的烘箱场景。我们需要几个指示灯？

1. 运行状态指示灯：对应输出点Q0.6。这个灯需要具备多种状态：熄灭（停止）、常亮（烘烤中）、闪烁（烘烤完成待机）。这正好展示了QLabel指示灯的动态状态管理能力。
2. 配方选择指示灯（可选但推荐）：对应M1.0,M1.1,M1.2。用户按下对应配方按钮时，相应的指示灯亮起（如绿色），其他配方灯熄灭，提供清晰的视觉反馈。

我们的目标就是用一个QLedLabel类（或类似管理方式）来优雅地驱动这些灯。

3. 基础构建：从零创建一个QLedLabel类

我们不满足于每次都在UI线程里直接操作QLabel的样式，而是希望封装一个可复用的、功能强大的指示灯控件。虽然不重写绘制，但我们可以通过继承QLabel来添加状态管理逻辑。

3.1 类定义与核心属性

首先，创建一个头文件qledlabel.h。

// qledlabel.h #ifndef QLEDLABEL_H #define QLEDLABEL_H #include <QLabel> #include <QTimer> class QLedLabel : public QLabel { Q_OBJECT // 定义一个Color枚举属性，方便在Qt Designer中查看和设置 Q_PROPERTY(Color ledColor READ ledColor WRITE setLedColor NOTIFY ledColorChanged) // 定义一个State枚举属性 Q_PROPERTY(State ledState READ ledState WRITE setLedState NOTIFY ledStateChanged) public: // 指示灯颜色枚举 enum Color { Red, Green, Yellow, Blue, Gray // 灰色表示熄灭或无效状态 }; Q_ENUM(Color) // 指示灯状态枚举 enum State { Off, // 熄灭 On, // 常亮 Blinking // 闪烁 }; Q_ENUM(State) explicit QLedLabel(QWidget *parent = nullptr, Color initColor = Gray, State initState = Off); ~QLedLabel(); Color ledColor() const; State ledState() const; public slots: // 设置颜色，同时更新样式 void setLedColor(Color color); // 设置状态，如果是Blinking则会启动/停止定时器 void setLedState(State state); // 便捷函数：一次性设置颜色和状态 void setLed(Color color, State state); // 开关函数，便捷操作 void turnOn(Color color); void turnOff(); void startBlinking(Color color, int intervalMs = 500); // 设置闪烁间隔 void stopBlinking(); signals: void ledColorChanged(Color color); void ledStateChanged(State state); private slots: void onBlinkTimeout(); // 定时器超时，切换显示/隐藏以实现闪烁 private: void updateStyleSheet(); // 根据当前颜色和状态更新样式表 void updateBlinkState(); // 更新闪烁时的视觉状态（亮/灭） Color m_color; State m_state; QTimer *m_blinkTimer; bool m_blinkVisible; // 闪烁时，当前是否可见 }; #endif // QLEDLABEL_H

3.2 核心实现逻辑解析

接下来是qledlabel.cpp的实现，这里包含了所有的核心逻辑。

// qledlabel.cpp #include "qledlabel.h" #include <QPainter> QLedLabel::QLedLabel(QWidget *parent, Color initColor, State initState) : QLabel(parent) , m_color(initColor) , m_state(initState) , m_blinkVisible(true) { m_blinkTimer = new QTimer(this); connect(m_blinkTimer, &QTimer::timeout, this, &QLedLabel::onBlinkTimeout); // 初始设置为一个固定大小，看起来更像一个“灯” this->setFixedSize(24, 24); // 关键：设置背景自动填充，否则圆形背景可能显示不全 this->setAutoFillBackground(true); // 设置对齐方式为居中，如果显示文本的话 this->setAlignment(Qt::AlignCenter); updateStyleSheet(); } QLedLabel::~QLedLabel() { if(m_blinkTimer->isActive()) { m_blinkTimer->stop(); } } QLedLabel::Color QLedLabel::ledColor() const { return m_color; } QLedLabel::State QLedLabel::ledState() const { return m_state; } void QLedLabel::setLedColor(Color color) { if (m_color != color) { m_color = color; // 如果当前是闪烁状态，更新样式表会影响闪烁的“亮”状态颜色 updateStyleSheet(); emit ledColorChanged(m_color); } } void QLedLabel::setLedState(State state) { if (m_state != state) { State oldState = m_state; m_state = state; // 状态切换时，管理定时器 if (oldState == Blinking && m_state != Blinking) { m_blinkTimer->stop(); m_blinkVisible = true; // 重置闪烁状态 } else if (oldState != Blinking && m_state == Blinking) { m_blinkVisible = true; m_blinkTimer->start(); // 启动闪烁，间隔在startBlinking中设置 } // 更新样式，例如从Blinking变为On，需要立刻显示为亮的颜色 updateStyleSheet(); emit ledStateChanged(m_state); } } void QLedLabel::setLed(Color color, State state) { // 先改颜色还是先改状态？这里顺序有讲究。 // 如果是从Off/On切换到Blinking，我们希望以指定的颜色开始闪烁。 // 因此，先设置颜色，再设置状态。 setLedColor(color); setLedState(state); } void QLedLabel::turnOn(Color color) { setLed(color, On); } void QLedLabel::turnOff() { setLed(Gray, Off); // 熄灭通常用灰色表示 } void QLedLabel::startBlinking(Color color, int intervalMs) { setLedColor(color); if (m_state != Blinking) { m_blinkTimer->setInterval(intervalMs); setLedState(Blinking); } else { // 已经是闪烁状态，只更新颜色和间隔 setLedColor(color); m_blinkTimer->setInterval(intervalMs); updateStyleSheet(); } } void QLedLabel::stopBlinking() { if (m_state == Blinking) { // 停止闪烁后，是保持亮还是灭？根据业务逻辑，通常保持亮（On）状态。 // 例如烘烤完成闪烁后，按下停止才熄灭。这里我们提供一个接口，外部可决定。 // 简单起见，我们先设置为常亮状态。 setLedState(On); } } void QLedLabel::onBlinkTimeout() { m_blinkVisible = !m_blinkVisible; updateBlinkState(); } void QLedLabel::updateStyleSheet() { QString colorName; switch(m_color) { case Red: colorName = "red"; break; case Green: colorName = "green"; break; case Yellow: colorName = "yellow"; break; case Blue: colorName = "blue"; break; case Gray: default: colorName = "lightgray"; break; } QString style; if (m_state == Off) { // 熄灭状态：灰色背景，深色边框 style = QString("QLabel { background-color: lightgray; border: 2px solid gray; border-radius: %1px; }") .arg(this->width() / 2); // 圆形 } else if (m_state == On) { // 常亮状态：彩色背景，带一点内发光效果 style = QString("QLabel { background-color: %1; border: 2px solid dark%1; border-radius: %2px; }") .arg(colorName).arg(this->width() / 2); } else { // Blinking // 闪烁状态：样式表只定义“亮”时的样子。“灭”的状态由updateBlinkState控制。 // 这里先设置为亮的状态，定时器会切换。 style = QString("QLabel { background-color: %1; border: 2px solid dark%1; border-radius: %2px; }") .arg(colorName).arg(this->width() / 2); } this->setStyleSheet(style); } void QLedLabel::updateBlinkState() { // 这是一个关键技巧：通过设置一个透明的背景色来模拟“熄灭” if (m_state == Blinking) { QString style; if (m_blinkVisible) { QString colorName; switch(m_color) { case Red: colorName = "red"; break; // ... 其他颜色 default: colorName = "green"; } style = QString("QLabel { background-color: %1; border: 2px solid dark%1; border-radius: %2px; }") .arg(colorName).arg(this->width() / 2); } else { // “灭”的状态：背景色设置为透明或与父窗口一致，边框颜色变浅 style = QString("QLabel { background-color: transparent; border: 2px solid lightgray; border-radius: %1px; }") .arg(this->width() / 2); } // 注意：直接设置styleSheet会覆盖之前的。在闪烁状态下，我们频繁设置。 // 对于性能影响微乎其微，因为只是一个控件。 this->setStyleSheet(style); } }

注意：在updateBlinkState中，我们通过频繁切换样式表来实现闪烁。对于单个控件这没问题，但如果界面上有几十上百个指示灯同时闪烁，可能会有性能顾虑。更高效的方法是在paintEvent中根据m_blinkVisible标志直接绘制，但这违背了我们使用QLabel的初衷。在实际工业场景中，同时闪烁的灯数量有限，此方法完全可行。如果确实需要高性能，可以考虑使用QPalette动态改变背景色，但样式表更直观强大。

4. 在烘箱控制项目中的实战应用

现在，我们将这个QLedLabel类应用到具体的烘箱控制逻辑中。假设我们使用Qt设计器（Qt Designer）拖出了一个界面，包含三个配方选择按钮（对应M1.0, M1.1, M1.2）、一个开始按钮（I0.6）、一个停止按钮（I0.7）、一个运行状态灯和一个配方选择指示灯组。

4.1 UI设计与控件提升

1. 在Qt Designer中，拖入三个QRadioButton或QPushButton（设置checkable=true）作为配方选择，分别命名为radioButton_Recipe1,radioButton_Recipe2,radioButton_Recipe3。
2. 拖入两个普通的QPushButton作为“开始”和“停止”，命名为pushButton_Start,pushButton_Stop。
3. 关键步骤：从左侧控件栏拖入一个普通的QLabel到界面上，用来表示运行状态灯。然后，在该QLabel上右键，选择“提升为...”。
   • 在“提升的类名称”中填写QLedLabel。
   • 在“头文件”中填写qledlabel.h。
   • 点击“添加”，然后“提升”。这样，这个QLabel在代码中就会被当作QLedLabel来使用。我们将其对象名改为led_RunStatus。
4. 同样，再拖入三个QLabel并提升为QLedLabel，作为配方选择指示灯，分别命名为led_Recipe1,led_Recipe2,led_Recipe3。

4.2 业务逻辑代码实现

在主窗口类（例如MainWindow）的头文件中，需要包含qledlabel.h，并声明必要的槽函数和私有成员，如定时器（用于烘烤计时和闪烁计时）。

// mainwindow.h (部分) #include "qledlabel.h" // ... 其他include class MainWindow : public QMainWindow { Q_OBJECT public: // ... 构造函数等 private slots: void onRecipeSelected(); // 配方选择变化 void onStartButtonClicked(); void onStopButtonClicked(); void onBakingTimeout(); // 烘烤完成 void onBlinkFinishTimeout(); // 完成闪烁后常亮2s结束，进入持续闪烁 private: Ui::MainWindow *ui; QTimer *m_bakingTimer; // 烘烤定时器 QTimer *m_finishBlinkTimer; // 完成闪烁后的2秒定时器 int m_selectedRecipeTime; // 当前选择的配方时间（毫秒） bool m_isBlinkingPhase; // 是否处于“烘烤完成后的闪烁阶段” // ... 可能还有其他状态变量 };

在mainwindow.cpp中，我们实现核心控制逻辑。

// mainwindow.cpp (部分) MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent) , ui(new Ui::MainWindow) , m_selectedRecipeTime(0) , m_isBlinkingPhase(false) { ui->setupUi(this); // 初始化定时器 m_bakingTimer = new QTimer(this); m_bakingTimer->setSingleShot(true); // 单次定时 connect(m_bakingTimer, &QTimer::timeout, this, &MainWindow::onBakingTimeout); m_finishBlinkTimer = new QTimer(this); m_finishBlinkTimer->setSingleShot(true); connect(m_finishBlinkTimer, &QTimer::timeout, this, &MainWindow::onBlinkFinishTimeout); // 连接信号槽 // 假设三个配方选择RadioButton在一个QButtonGroup里，或者分别连接 connect(ui->radioButton_Recipe1, &QRadioButton::toggled, this, &MainWindow::onRecipeSelected); connect(ui->radioButton_Recipe2, &QRadioButton::toggled, this, &MainWindow::onRecipeSelected); connect(ui->radioButton_Recipe3, &QRadioButton::toggled, this, &MainWindow::onRecipeSelected); connect(ui->pushButton_Start, &QPushButton::clicked, this, &MainWindow::onStartButtonClicked); connect(ui->pushButton_Stop, &QPushButton::clicked, this, &MainWindow::onStopButtonClicked); // 初始化指示灯状态 ui->led_RunStatus->turnOff(); // 运行灯熄灭 ui->led_Recipe1->turnOff(); ui->led_Recipe2->turnOff(); ui->led_Recipe3->turnOff(); } void MainWindow::onRecipeSelected() { // 更新配方选择指示灯，并记录时间 ui->led_Recipe1->setLed(QLedLabel::Green, ui->radioButton_Recipe1->isChecked() ? QLedLabel::On : QLedLabel::Off); ui->led_Recipe2->setLed(QLedLabel::Green, ui->radioButton_Recipe2->isChecked() ? QLedLabel::On : QLedLabel::Off); ui->led_Recipe3->setLed(QLedLabel::Green, ui->radioButton_Recipe3->isChecked() ? QLedLabel::On : QLedLabel::Off); if (ui->radioButton_Recipe1->isChecked()) { m_selectedRecipeTime = 6000; // 6秒 } else if (ui->radioButton_Recipe2->isChecked()) { m_selectedRecipeTime = 10000; // 10秒 } else if (ui->radioButton_Recipe3->isChecked()) { m_selectedRecipeTime = 12500; // 12.5秒 } else { m_selectedRecipeTime = 0; } } void MainWindow::onStartButtonClicked() { // 开始按钮对应I0.6 if (m_selectedRecipeTime <= 0) { QMessageBox::warning(this, "警告", "请先选择产品配方！"); return; } if (m_bakingTimer->isActive() || m_isBlinkingPhase) { // 如果正在烘烤或闪烁，再次点击开始可能无效，或视为重新开始（根据需求） // 这里我们设计为：如果正在运行，则停止当前流程并重新开始 onStopButtonClicked(); } // 1. 停止任何可能正在进行的闪烁 ui->led_RunStatus->stopBlinking(); // 2. 运行灯常亮（绿色表示运行中） ui->led_RunStatus->turnOn(QLedLabel::Green); // 3. 启动烘烤定时器 m_bakingTimer->start(m_selectedRecipeTime); m_isBlinkingPhase = false; qDebug() << "开始烘烤，时长：" << m_selectedRecipeTime << "ms"; } void MainWindow::onStopButtonClicked() { // 停止按钮对应I0.7，任何时刻按下都停止 m_bakingTimer->stop(); m_finishBlinkTimer->stop(); m_isBlinkingPhase = false; // 停止运行灯的闪烁，并熄灭 ui->led_RunStatus->stopBlinking(); // 先停止闪烁定时器 ui->led_RunStatus->turnOff(); // 再熄灭 qDebug() << "烘烤已停止"; } void MainWindow::onBakingTimeout() { // 烘烤时间到 qDebug() << "烘烤完成，进入完成指示阶段"; // 1. 运行灯开始闪烁（例如黄色），表示烘烤完成，等待处理 ui->led_RunStatus->startBlinking(QLedLabel::Yellow, 500); // 500ms间隔闪烁 // 2. 启动一个2秒的单次定时器，2秒后进入持续闪烁阶段（如果需要） // 根据需求：“烘烤完毕指示灯常亮2s后一直闪烁” // 这里需要解读：是“先常亮2秒，然后开始闪烁”，还是“先闪烁，2秒后改变闪烁状态”？ // 从常见逻辑看，可能是“烘烤完成 -> 灯常亮2秒 -> 然后开始闪烁直到人工停止” // 但我们之前的逻辑是“完成即开始闪烁”。我们调整一下： // 修改：烘烤完成 -> 灯常亮2秒（绿色） -> 然后开始闪烁（黄色） // 停止可能由startBlinking启动的定时器（如果我们调整逻辑） ui->led_RunStatus->stopBlinking(); // 先常亮2秒（比如用绿色常亮表示“完成待机”） ui->led_RunStatus->turnOn(QLedLabel::Green); // 启动2秒定时器，结束后进入持续闪烁 m_finishBlinkTimer->start(2000); m_isBlinkingPhase = true; // 标记进入完成后的闪烁阶段 } void MainWindow::onBlinkFinishTimeout() { // 2秒常亮结束，进入持续闪烁状态 if (m_isBlinkingPhase) { ui->led_RunStatus->startBlinking(QLedLabel::Yellow, 500); qDebug() << "进入持续闪烁提示状态"; } }

4.3 关键细节与注意事项

1. 状态管理是核心：整个代码围绕m_isBlinkingPhase、定时器状态等变量展开。清晰的状态机是逻辑正确的保证。务必在每次状态转换时（如开始、停止、超时）都准确更新这些状态变量和指示灯。
2. 定时器的正确使用：我们用了两个QTimer，一个用于烘烤（单次），一个用于完成后的2秒常亮（单次）。QLedLabel内部的闪烁用了另一个定时器。要管理好它们的生命周期和启停关系，尤其是在onStopButtonClicked中，必须全部停止。
3. 线程安全：所有对UI控件（包括QLedLabel）的操作都必须在主线程（GUI线程）中进行。QTimer::timeout信号对应的槽函数是在主线程被调用的，所以是安全的。如果你的烘烤计时来源于其他线程（如PLC通讯线程），必须通过信号槽机制将状态传递回主线程更新UI。
4. 样式表的性能：在QLedLabel::updateBlinkState中频繁调用setStyleSheet。对于单个灯，这没有问题。如果界面极其复杂，可以考虑优化，例如在paintEvent中实现，或者使用QPalette。但99%的场景下，样式表的方式更简单可靠。

5. 高级技巧与扩展优化

基础的指示灯已经实现了，但一个健壮的工业控件还需要考虑更多。

5.1 外观深度定制

我们的样式表目前比较简单。你可以通过更丰富的QSS来打造更逼真的LED效果：

// 模拟带有光泽感的LED QString style = QString( "QLabel {" " background-color: qradialgradient(" " cx: 0.5, cy: 0.5, radius: 0.8," " fx: 0.3, fy: 0.3," " stop: 0 %1," " stop: 1 #000000" " );" " border: 2px solid dark%1;" " border-radius: %2px;" "}" ).arg(colorName).arg(this->width() / 2);

这段代码使用径向渐变，中心亮边缘暗，模拟了LED的发光质感。你还可以添加min-width和min-height来确保控件在布局中保持圆形。

5.2 动态效果与动画

Qt的图形视图框架（Graphics View）或属性动画（QPropertyAnimation）能实现更平滑的效果，比如颜色渐变、呼吸灯效果。但对于简单的状态指示，定时器切换样式表已经足够。如果追求极致平滑，可以继承QWidget，在paintEvent中使用QPainter和动画系统来绘制。

5.3 与硬件信号绑定

在真实的工业软件中，指示灯的状态往往直接绑定到某个变量或信号上。我们可以扩展QLedLabel，使其能够自动监听一个布尔值或枚举值。

// 在QLedLabel中添加 public slots: void bindToBool(bool value, Color trueColor = Green, Color falseColor = Gray); void bindToInt(int value, QHash<int, QPair<Color, State>> stateMap); // 映射整数值到灯的状态 // 实现 void QLedLabel::bindToBool(bool value, Color trueColor, Color falseColor) { if (value) { setLed(trueColor, On); } else { setLed(falseColor, Off); } }

这样，在业务逻辑中，只需要将PLC读取到的I0.6（开始信号）或Q0.6（输出状态）的布尔值变化信号，连接到led_RunStatus的bindToBool槽函数即可，实现数据驱动UI。

5.4 多线程与信号槽安全

如前所述，如果状态更新来源于工作线程（如一个持续读取PLC的线程），务必使用QueuedConnection方式连接信号槽，或者通过QMetaObject::invokeMethod在主线程中调用更新方法，确保UI操作线程安全。

// 在工作线程中 void PlcReaderThread::onDataUpdated(bool runStatus) { // 错误：直接调用UI控件方法 // emit updateRunLedSignal(runStatus); // 正确，通过信号槽 } // 在主窗口类中连接 connect(plcThread, &PlcReaderThread::updateRunLedSignal, ui->led_RunStatus, &QLedLabel::bindToBool); // 自动是QueuedConnection

6. 常见问题与排查实录

在实际开发中，你可能会遇到以下问题：

问题1：指示灯不显示圆形，而是方形。

• 原因：border-radius的值设置不正确，或者QLabel的autoFillBackground属性未设置为true。
• 解决：确保在构造函数中调用了setAutoFillBackground(true)。并且border-radius的值应至少为控件短边长度的一半。使用this->width() / 2是动态计算的好方法，但要确保控件初始化时大小已经确定，或者监听resizeEvent来动态更新样式表。

问题2：闪烁效果卡顿或不均匀。

• 原因：系统负载过高，或者在同一线程中有阻塞操作，导致定时器事件不能及时处理。
• 解决：检查主线程是否被复杂计算阻塞。确保闪烁逻辑简单高效（就像我们只用setStyleSheet）。对于大量指示灯，考虑使用一个统一的定时器来管理所有灯的闪烁状态，而不是每个灯一个定时器。

问题3：在布局中，指示灯大小被拉伸变形。

• 原因：布局管理器（如QHBoxLayout、QGridLayout）会默认拉伸控件以适应空间。
• 解决：为QLedLabel设置一个固定的sizePolicy，或者设置minimumSize和maximumSize为相同值，强制其保持固定大小。

  led->setSizePolicy(QSizePolicy::Fixed, QSizePolicy::Fixed); led->setFixedSize(24, 24);

问题4：样式表在闪烁时，控件出现短暂“空白”或残留。

• 原因：在updateBlinkState中，将背景色设置为transparent时，如果父控件没有统一的背景色，可能会看到下层控件。
• 解决：将“灭”的状态背景色设置为与父控件背景色一致的颜色（如background-color: palette(window);），而不是透明。或者，更好的方法是，在“灭”的状态下，将边框和背景色都设置为一个暗色（如darkGray），模拟熄灭的LED，这样视觉效果更稳定。

问题5：提升后的控件在Qt Designer中看不到自定义属性。

• 原因：Qt Designer需要编译你的控件插件才能识别自定义属性和图标。
• 解决（简易版）：对于简单项目，可以忽略Designer中的预览，直接编译运行即可。或者，在代码中动态创建QLedLabel并设置属性，而不是在Designer中提升。

通过以上从原理到实践，再到问题排查的完整拆解，相信你已经掌握了使用QLabel打造一套专业、响应式指示灯系统的全部技能。这套方案代码清晰、耦合度低、易于维护和扩展，足以应对大多数工业HMI、设备监控等场景下的状态指示需求。下次再需要指示灯时，别再寻找第三方控件了，试试这个纯QLabel的方案吧。