快捷導(dǎo)航

Qt中讀取csv文件的三種主要方法

更新時(shí)間：2026年01月28日 09:23:25 作者：SunkingYang

本文介紹了在Qt中讀取CSV文件的三種主要方法：基礎(chǔ)方法（QFile+QTextStream）、模型法（QStandardItemModel）和數(shù)據(jù)庫法（QSqlDatabase）,基礎(chǔ)方法適合直接處理數(shù)據(jù),模型法便于界面展示,數(shù)據(jù)庫法則適用于復(fù)雜查詢,文章提供了詳細(xì)的代碼示例,需要的朋友可以參考下

讀取方法概覽

方法	核心思路	適用場(chǎng)景	優(yōu)勢(shì)
基礎(chǔ)方法 (QFile + QTextStream)	逐行讀取，使用 split 按逗號(hào)分割字符串。	數(shù)據(jù)量不大，無需界面顯示，直接進(jìn)行邏輯處理。	簡(jiǎn)單直觀，代碼量少。
模型法 (QStandardItemModel)	將數(shù)據(jù)讀入數(shù)據(jù)模型，可直接綁定到QTableView等視圖組件。	需要在圖形界面（如表格）中展示和編輯數(shù)據(jù)。	與Qt的Model/View架構(gòu)無縫集成，便于顯示。
數(shù)據(jù)庫法 (QSqlDatabase)	將CSV文件作為數(shù)據(jù)源導(dǎo)入，使用SQL語句進(jìn)行查詢操作。	需要進(jìn)行復(fù)雜的數(shù)據(jù)查詢、篩選或與數(shù)據(jù)庫交互。	可利用SQL強(qiáng)大查詢能力。

基礎(chǔ)方法：直接讀取與處理

這是最常用和靈活的方法，適合在內(nèi)存中直接操作數(shù)據(jù)。

#include <QFile>
#include <QTextStream>
#include <QStringList>
#include <QDebug>

// 讀取CSV文件函數(shù)
bool readCsv(const QString &filePath, QList<QStringList>> &data) {
    QFile file(filePath);
    if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) {
        qDebug() << "無法打開文件:" << filePath;
        return false;
    }

    QTextStream in(&file);
    // 設(shè)置編碼，通常為UTF-8
    in.setEncoding(QStringConverter::Utf8);

    while (!in.atEnd()) {
        QString line = in.readLine().trimmed(); // 讀取一行并去除首尾空白
        if (line.isEmpty()) continue; // 跳過空行

        // 使用逗號(hào)分割字符串，得到一行的數(shù)據(jù)列表
        QStringList row = line.split(',', Qt::SkipEmptyParts);
        data.append(row);
    }

    file.close();
    return true;
}

// 使用示例
int main() {
    QList<QStringList>> csvData;
    if (readCsv("data.csv", csvData)) {
        for (int i = 0; i < csvData.size(); ++i) {
            QStringList row = csvData.at(i);
            qDebug() << "第" << i << "行:" << row;
            // 進(jìn)一步處理每個(gè)單元格的數(shù)據(jù)，例如轉(zhuǎn)換為數(shù)字
            // double value = row.at(0).toDouble();
        }
    }
    return 0;
}

模型法：在界面表格中顯示

如果你希望將CSV數(shù)據(jù)直接顯示在Qt的表格視圖（如QTableView）中，使用QStandardItemModel非常方便。

#include <QStandardItemModel>
#include <QTableView>

// 讀取CSV文件到數(shù)據(jù)模型
QStandardItemModel* readCsvToModel(const QString &filePath) {
    QFile file(filePath);
    if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) {
        return nullptr;
    }

    QStandardItemModel *model = new QStandardItemModel;
    QTextStream in(&file);
    in.setEncoding(QStringConverter::Utf8);

    int row = 0;
    while (!in.atEnd()) {
        QString line = in.readLine();
        if (line.isEmpty()) continue;

        QStringList cellList = line.split(',', Qt::SkipEmptyParts);
        for (int col = 0; col < cellList.size(); ++col) {
            QString cell = cellList.at(col).trimmed();
            QStandardItem *item = new QStandardItem(cell);
            model->setItem(row, col, item);
        }
        row++;
    }
    file.close();
    return model;
}

// 在窗口類中使用示例
// 假設(shè)有一個(gè)QTableView控件指針 ui->tableView
void MainWindow::loadCsvFile() {
    QStandardItemModel *model = readCsvToModel("data.csv");
    if (model) {
        ui->tableView->setModel(model);
    }
}

重要注意事項(xiàng)

在實(shí)際使用中，還需要注意以下幾點(diǎn)：

編碼問題：CSV文件可能有不同的字符編碼（如UTF-8, GBK）。如果出現(xiàn)亂碼，需要使用QTextStream::setEncoding指定正確的編碼，或使用QTextCodec進(jìn)行轉(zhuǎn)換。
數(shù)據(jù)有效性：從CSV讀取的每個(gè)單元格數(shù)據(jù)都是QString類型。如果需要數(shù)值，應(yīng)使用toInt(), toDouble()等方法轉(zhuǎn)換，并檢查是否成功。
大文件處理：對(duì)于非常大的CSV文件，一次性讀取所有內(nèi)容可能占用過多內(nèi)存?？梢钥紤]逐行讀取并即時(shí)處理，而不是全部加載到QList或模型中。
格式復(fù)雜性：上面的簡(jiǎn)單split(',')方法適用于標(biāo)準(zhǔn)CSV。但如果數(shù)據(jù)內(nèi)本身包含逗號(hào)或換行符（通常會(huì)用引號(hào)括起來），這種解析就不準(zhǔn)確了。處理這種復(fù)雜情況需要更完善的解析邏輯。