Qt C++：简洁高效写入QString到CSV文件及乱码问题排查

算力阿峰

2026-5-21

解决QString写入CSV文件乱码的问题

嘿，我之前也遇到过完全一样的问题！你看到的"???????"乱码，本质是QTextStream的默认编码和CSV需要的UTF-8不匹配——Qt在不同系统下默认编码会跟着系统走（比如Windows默认是GBK），但CSV文件要保证跨平台可读性，必须用UTF-8编码才行。

给你两个简洁高效的修正方案，随便选一个都能解决问题：

方案1：给QTextStream设置UTF-8编码（推荐，兼容Excel）

如果要让Excel也能正确识别你的CSV内容，最好还加上UTF-8的BOM（字节顺序标记），不然Excel打开UTF-8文件有时还是会乱码。修改后的代码如下：

QString path = QCoreApplication::applicationDirPath() + "/myfile.csv";
QFile file(path);
QString mystring = "Hello, world! 你好，世界！";

// 打开文件时加上Text标志，自动处理跨平台换行符
if (!file.open(QIODevice::WriteOnly | QIODevice::Text)) {
    qDebug() << "打开文件失败：" << file.errorString();
    return;
}

QTextStream out(&file);
// 设置编码为UTF-8，并生成BOM
out.setCodec("UTF-8");
out.setGenerateByteOrderMark(true);
out << mystring;

file.close(); // QFile对象析构时也会自动关闭，不过显式关闭也没问题

方案2：直接写入UTF-8字节（更轻量）

要是你不想用QTextStream，直接把QString转成UTF-8字节写入文件也可以，步骤更简单：

QString path = QCoreApplication::applicationDirPath() + "/myfile.csv";
QFile file(path);
QString mystring = "Hello, world! 你好，世界！";

if (!file.open(QIODevice::WriteOnly)) {
    qDebug() << "打开文件失败：" << file.errorString();
    return;
}

// 把QString转成UTF-8字节数组，直接写入
file.write(mystring.toUtf8());
file.close();