如何在编译期自动统计progress()调用次数 避免Qt进度条数值异常

首先明确：标准C预处理器本身不支持跨函数/跨代码块统计某个函数的总调用次数，我们可以用以下两种低成本方案规避手动维护总节点数的问题，完全避免进度超100%的异常。

方案1：枚举节点法（最易维护，推荐） #

把所有进度节点统一维护在枚举里，总节点数直接取枚举的最后一个计数位，新增/删除节点只需修改枚举即可，无需改动其他逻辑：

改造后的task.h代码 #

#include <QtMath>

class Task : public QObject
{
    Q_OBJECT

    // 进度节点定义，新增节点只需要在这里加，StepCount自动更新总数量
    enum ProgressStep {
        StepBeforeFunc1,
        StepAfterFunc1,
        StepAfterFunc2,
        StepFunc1Inner, // 新增func1内部节点直接加在这里
        StepCount // 固定放在最后，自动表示总节点数
    };

    const float m_total = StepCount;
    int count = 0;

public:
    explicit Task(QObject *parent = nullptr){}

    void doSomething()
    {
        // 不再需要外部传入total，直接用枚举的StepCount
        progress();
        func1();
        progress();
        func2();
        progress();
    }

private:
    void progress()
    {
        // 加边界保护，即使多调用也不会超100%
        float p = qMin((++count/m_total)*100, 100.0f);
        emit status(p);
    }

    void func1()
    {
        progress(); // 这里取消注释也不用改其他参数
    }

    void func2()
    {
//        progress();
    }

signals:
    void status(float p);
};

改造后的widget.h代码 #

class Widget : public QWidget
{
    Q_OBJECT

    Task m_task;

public:
    Widget(QWidget *parent = nullptr)
    {
        connect(&m_task, &Task::status, this, &Widget::showProgrss);
        // 不再需要手动传total参数
        m_task.doSomething();
    }

public slots:
    void showProgrss(float p)
    {
        qDebug() << " - progress" << p;
    }
};

这个方案的优势是逻辑简单无黑盒，所有Qt版本都支持，维护成本极低。

方案2：编译期计数器实现（C++20及以上支持） #

如果不想维护枚举，可以用C++20的constexpr编译期统计能力配合宏实现自动计数，核心是利用编译期函数的状态记录，代码示例如下：

// 编译期计数器前置定义
#define BASE_COUNTER __COUNTER__
template <int Id>
constexpr int get_total_nodes() {
    return __COUNTER__ - BASE_COUNTER - 1;
}

// 替换progress调用的宏
#define PROGRESS() do { progress(); } while(0)

不过这个方案依赖编译器扩展，兼容性不如方案1，生产环境更推荐用枚举方案。

额外防护措施 #

不管用哪种方案，都建议在progress函数里加边界截断，避免极端情况出现进度超过100%的问题：

float p = qMin((++count / m_total) * 100.0f, 100.0f);

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