C++ Qt QString转string乱码的处理方法

关注

原创最新推荐文章于 2026-07-30 13:20:00 发布 5.4k 阅读 AI 写同款· GEO 优化 ›

qt5的中文乱码问题，QString、QStringLiteral 为 UTF-16 编码 qt5的中文乱码问题一直没有很明确的处理方案。今天处理进程间通信时，也遇到了qt5乱码问题，一边是设置的GBK，一边设置的是UTF8，单向通信约定采用UTF8。发送端保证发的是UTF8字符串，因为UTF8在网络数据包中没有字节序问题。问题出在发送端，字符串的原始编码不明确，转换方案一直靠猜，咨询多个AI助手，也都是胡乱猜测，没有一个能解决，没有一个能给出确定解释。类似于，在一个陌生环境，自己不知道自己在哪。阅读详情

QString在转string时，如果有中文，会出现乱码，如果是文件名，那么读文件时就会出现空指针现象，还是要多注意。

例如下面的代码

#include <QCoreApplication>
#include <QDebug>
#include <string>
#include <iostream>

using namespace std;

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    QString qstr1 = "D:/测试视频/笑傲江湖第1集.mp412345A";
    std::string str1 = qstr1.toStdString();
    qDebug() << qstr1;
    cout << str1 << endl;

    return a.exec();
}

运行结果
在这里插入图片描述

由于有中文，QString转std::string时不能直接使用toStdString，如果把QString转为u8, 再转string依然是乱码，如下图：
在这里插入图片描述

那该如何解决呢，下面提供解决办法，代码如下：

#include <QCoreApplication>
#include <QDebug>
#include <string>
#include <iostream>

using namespace std;

string qstr2str(const QString& qstr)
{
    QByteArray cdata = qstr.toLocal8Bit();
    return string(cdata);
}


int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    QString qstr1 = u8"D:/测试视频/笑傲江湖第1集.mp412345";
    //std::string str1 = qstr1.toStdString();
    std::string str1 = qstr2str(qstr1);
    qDebug() << qstr1;
    cout << str1 << endl;

    return a.exec();
}

toLocal8Bit()的解释如下：
Returns the local 8-bit representation of the string as a QByteArray. The returned byte array is undefined if the string contains characters not supported by the local 8-bit encoding.
QTextCodec::codecForLocale() is used to perform the conversion from Unicode. If the locale encoding could not be determined, this function does the same as toLatin1().
If this string contains any characters that cannot be encoded in the locale, the returned byte array is undefined. Those characters may be suppressed or replaced by another.

string转QString也会乱码，解决方法如下：

//string转QString
QString str2qstr(const string& str)
{
    return QString::fromLocal8Bit(str.data());
}

测试代码如下：

#include <QCoreApplication>
#include <QDebug>
#include <string>
#include <iostream>

using namespace std;

//QString转string
string qstr2str(const QString& qstr)
{
    QByteArray cdata = qstr.toLocal8Bit();
    //QByteArray cdata = qstr.toUtf8();  //string乱码
    return string(cdata);
}

//string转QString
QString str2qstr(const string& str)
{
    return QString::fromLocal8Bit(str.data());
}

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    QString name = u8"D:/测试视频/笑傲江湖第1集.mp412345";
    //std::string sname = qstr1.toStdString();
    std::string sname = qstr2str(name);
    qDebug() << name;
    cout << sname << endl;

    string sname2 = "abc天龙八部123";
    cout << "带中文的string " << sname2 << endl;
    QString name2 = str2qstr(sname2);
    qDebug() << u8"string转QString的结果 --> " << name2;

    return a.exec();
}