如何从NewsAPI快速请求100+图片并设置为QListWidget图标？

针对100+张图片的加载效率问题，核心优化方向是并行请求+异步处理+缓存复用，以下是具体实现思路：

1. 并行网络请求（替代串行请求） #

默认串行请求会逐个等待响应，效率极低。用Qt的QThreadPool配合QRunnable实现多线程并行请求，同时控制并发数（建议10-20，避免触发API限流）：

class ImageDownloadRunnable : public QRunnable {
public:
    ImageDownloadRunnable(const QString& url, int itemIndex, QObject* receiver)
        : m_url(url), m_itemIndex(itemIndex), m_receiver(receiver) {}

    void run() override {
        QNetworkAccessManager manager;
        QNetworkReply* reply = manager.get(QNetworkRequest(QUrl(m_url)));
        QEventLoop loop;
        QObject::connect(reply, &QNetworkReply::finished, &loop, &QEventLoop::quit);
        loop.exec();

        if (reply->error() == QNetworkReply::NoError) {
            QByteArray data = reply->readAll();
            // 发送信号到主线程更新UI
            QMetaObject::invokeMethod(m_receiver, "onImageDownloaded",
                Qt::QueuedConnection,
                Q_ARG(int, m_itemIndex),
                Q_ARG(QByteArray, data));
        }
        reply->deleteLater();
    }

private:
    QString m_url;
    int m_itemIndex;
    QObject* m_receiver;
};

// 使用方式
QThreadPool::globalInstance()->setMaxThreadCount(15); // 设置最大并发数
for (int i = 0; i < newsItems.count(); ++i) {
    QString imageUrl = newsItems[i]["urlToImage"].toString();
    if (!imageUrl.isEmpty()) {
        ImageDownloadRunnable* runnable = new ImageDownloadRunnable(imageUrl, i, this);
        runnable->setAutoDelete(true);
        QThreadPool::globalInstance()->start(runnable);
    }
}

2. 本地图片缓存（避免重复请求） #

用QDiskCache实现本地缓存，根据图片URL的哈希值作为缓存键，加载前先查缓存：

QDiskCache* imageCache = new QDiskCache(this);
imageCache->setCacheDirectory(QStandardPaths::writableLocation(QStandardPaths::CacheLocation) + "/news_images");
imageCache->setMaxCacheSize(10 * 1024 * 1024); // 10MB缓存上限

// 下载前先检查缓存
QByteArray cachedData = imageCache->data(qHash(imageUrl));
if (!cachedData.isEmpty()) {
    // 直接用缓存数据更新图标
    updateListItemIcon(itemIndex, cachedData);
    return;
}

// 下载成功后存入缓存
imageCache->insert(qHash(imageUrl), data);

3. 异步图片解码与缩放 #

图片解码和缩放是耗时操作，不要在主线程执行，在子线程完成后再传递给主线程：

// 在ImageDownloadRunnable的run()方法中，下载完成后添加解码逻辑
QImageReader reader;
reader.setDevice(new QBuffer(&data));
reader.setScaledSize(QSize(64, 64)); // 缩放到图标尺寸
QImage image = reader.read();
if (!image.isNull()) {
    // 注意：QPixmap不能跨线程传递，转成QImage传递
    QMetaObject::invokeMethod(m_receiver, "onImageReady",
        Qt::QueuedConnection,
        Q_ARG(int, m_itemIndex),
        Q_ARG(QImage, image));
}

4. 批量UI更新减少重绘 #

不要下载一张就更新一个列表项，攒够一定数量（比如10张）再一次性更新，减少UI重绘次数：

// 主线程维护待更新队列
QMap<int, QImage> pendingUpdates;

void onImageReady(int index, const QImage& image) {
    pendingUpdates[index] = image;
    if (pendingUpdates.size() >= 10) {
        updateBatchItems();
    }
}

void updateBatchItems() {
    for (auto it = pendingUpdates.constBegin(); it != pendingUpdates.constEnd(); ++it) {
        QListWidgetItem* item = ui->listWidget->item(it.key());
        if (item) {
            item->setIcon(QIcon(QPixmap::fromImage(it.value())));
        }
    }
    pendingUpdates.clear();
}

// 所有请求完成后处理剩余待更新项
void onAllRequestsFinished() {
    if (!pendingUpdates.isEmpty()) {
        updateBatchItems();
    }
}

5. 请求节流与重试机制 #

避免短时间内发送过多请求触发API限流，用QTimer控制请求间隔，同时添加重试逻辑：

// 用定时器分批发送请求
QTimer* requestTimer = new QTimer(this);
int currentIndex = 0;
QList<int> failedIndices; // 记录请求失败的项索引

connect(requestTimer, &QTimer::timeout, this, [&]() {
    int targetIndex = currentIndex < newsItems.count() ? currentIndex : failedIndices.takeFirst();
    
    QString imageUrl = newsItems[targetIndex]["urlToImage"].toString();
    if (!imageUrl.isEmpty()) {
        startImageDownload(imageUrl, targetIndex);
    }

    if (currentIndex < newsItems.count()) {
        currentIndex++;
    } else if (failedIndices.isEmpty()) {
        requestTimer->stop();
        onAllRequestsFinished();
    }
});
requestTimer->start(50); // 每50ms发送一个请求，可根据API限流规则调整

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