Qt6如何正确拆分含引号内嵌逗号的CSV格式QString

你之前使用split()方法拆分CSV失败的核心原因是：CSV属于结构化格式，分隔符的生效有上下文规则（引号包裹范围内的逗号不属于分隔符），简单的字符串匹配无法识别该规则，所以不管怎么调整split的匹配参数都无法完全覆盖场景。

针对Qt6环境，最优方案如下：

无需引入外部依赖的实现方案（推荐绝大多数场景使用） #

你可以自己实现符合RFC4180 CSV标准的解析逻辑，逐字符判断当前是否处于引号包裹状态，仅对非引号范围内的逗号做拆分，同时兼容双引号转义规则。

可直接使用的解析函数示例：

#include <QString>
#include <QStringList>

QStringList parseSingleCsvLine(const QString& line)
{
    QStringList resultFields;
    QString currentField;
    bool isInQuotes = false;
    const int lineLength = line.size();

    for (int i = 0; i < lineLength; ++i) {
        const QChar currentChar = line.at(i);
        if (currentChar == '"') {
            // 处理连续双引号的转义逻辑：两个连续双引号代表单个双引号字符
            if (i + 1 < lineLength && line.at(i + 1) == '"') {
                currentField += '"';
                i++;
            } else {
                // 切换引号包裹状态
                isInQuotes = !isInQuotes;
            }
        } else if (currentChar == ',' && !isInQuotes) {
            // 仅非引号范围内的逗号作为分隔符
            resultFields.append(currentField);
            currentField.clear();
        } else {
            currentField += currentChar;
        }
    }
    // 追加最后一个字段
    resultFields.append(currentField);
    return resultFields;
}

使用方式 #

逐行读取CSV文件后，将每一行字符串传入该函数，即可得到正确拆分后的字段列表，不会拆分引号内嵌的逗号。

写入注意事项 #

编辑完成后写回CSV文件时，需要遵循相同规则：如果字段内容包含逗号、双引号、换行符，需要用双引号将整个字段包裹，字段内的双引号替换为两个连续双引号，避免后续读取出现格式错误。

复杂场景备选方案 #

如果你的需求包含处理带换行的字段、批量读写大文件、多编码自动适配等复杂功能，可以集成专门适配Qt的轻量CSV处理库，不需要引入其他第三方依赖。

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