QT输出的中文乱码，例如qDebug、printf、QString等的中文输出乱码

来源链接：https://blog.csdn.net/qq_31073871/article/details/81364983

 

参考：《QString 乱谈(3)-Qt5与中文》https://blog.csdn.net/dbzhang800/article/details/7542672

《字符编码：Unicode和UTF-8之间的关系》https://blog.csdn.net/xiaolei1021/article/details/52093706/

根据以上两篇文章，我得知：QString默认是UTF-8编码的，UTF8是unicode的一种实现方式。uincode的全称我也不知道是啥，可能是：uinque code唯一编码，或者universal code全球编码，这两个词意义差别不大，反正就是世界上所有的文字符号，在unicode体系中，只有一个唯一的数字与之对应。程序员世界中最常见的一种编码就是ASCII，这个体系只能容纳128个英文字符，扩展ASCII体系也只能容纳256个字符，而unicode体系能容纳地球上几百万个不同的符号。

QT中还有2个概念非常重要：

源码字符集(the source character set)	源码文件是使用何种编码保存的
执行字符集(the execution character set)	可执行程序内保存的是何种编码(程序执行时内存中字符串编码)

 

总体来说，解决方法就一个：你必须知道源码的编码和执行的编码。

执行的编码我们也可以这样修改：

#pragma execution_character_set("utf-8")

 
 

QT的QString默认情况下只能正确显示UTF-8编码的字符串，因此，我们必须保证，要显示的字符串首先要转换为UTF-8，再进行显示。当然，我们也可以用代码人为的设定QString的编码。

然而，默认情况下，QT的编辑器是GB2312编码，QString是UTF-8编码，这时就会乱码，可以使用下文的方法一，把编码转为QString支持的编码

最简洁的方法就是：把源码改为UTF-8编码，这样不用做任何转换，直接就能正确显示，例如:

 
 

   
   

    
    

   
   
   
   

    
    

     
     QString str=
     
     "这是汉字";
    
    
   
   

   
   

    
    

   
   
   
   

    
    

     
     ui->textEdit->append(str);
    
    
   
   
 
 

 

如果源码为GB2312，QString默认为为UTF-8，这时，要这样写才不会乱码：

 
 

   
   

    
    

   
   
   
   

    
    
 
    
    
   
   

   
   

    
    

   
   
   
   

    
    

     
     QString str= QString::fromLocal8Bit(
     
     "这是汉字");
    
    
   
   

   
   

    
    

   
   
   
   

    
    

     
     ui->textEdit->append(str);
    
    
   
   
 
 

这个例子是把本地编码（我们的操作系统得编码大多为GB2312），转换为QString支持的编码。
PS：QString支持的编码是可以设置的，但是，任何时刻，都只能有一种编码生效。

 

 

基础知识：如何修改代码源文件的编码？依次点击->编辑->select encoding->按选择的编码重新载入/按选择的编码保存文件。

（1）若源文件编码为UTF8，那么程序中的汉字就可以直接显示，例如：ui->textedit_2->append("这是汉字");这句程序可以正确运行。

（2）源文件编码选择为GB2312，或者GBK，或者GB18030，ui->textedit_2->append("这是汉字");这句程序运行时会显示为乱码。这时要这样写才不会乱码：ui->textedit_2->append(QString::fromLocal8Bit("这是汉字"));显然fromLocal8Bit的作用就是把本地源代码中GB2312编码的字符串转换为了QString默认的编码UTF-8。PS：在简体中文的电脑上，local8bit编码等价于GBK编码。

 

 

方法一：
QString::fromUtf8("这是汉字");//在源代码为UTF8时使用
QString::fromLocal8Bit("这是汉字")//在本地编码转为UTF8时使用
QStringLiteral("这是汉字");

以上这些直接定义为宏即可方便使用，例如：

#define TR(str)   (QString::fromLocal8Bit(str))  //解决中文乱码
 
 

 

方法二：

 
 

   
   

    
    

   
   
   
   

    
    

     
     #include 
     
     <
     
     QTextCodec
     
     >
    
    
   
   

   
   

    
    

   
   
   
   

    
    

     
     QTextCodec *codec = QTextCodec::codecForName("GBK");
    
    
   
   

   
   

    
    

   
   
   
   

    
    

     
     char buf[300];
    
    
   
   

   
   

    
    

   
   
   
   

    
    

     
     int real_len = serial.read(buf, sizeof(buf));
    
    
   
   

   
   

    
    

   
   
   
   

    
    

     
     QString chinese_str = codec->toUnicode(
     
     buf, real_len);
    
    
   
   
该方法有个小缺点，就是形参仅支持char*的字符串，不支持QString的字符串
本方法也可封装为宏，以便使用。

 
 

 
 

   
   

    
    

   
   
   
   

    
    

     
     #include <comfunc_qt.cpp>
    
    
   
   

   
   

    
    

   
   
   
   

    
    
 
    
    
   
   

   
   

    
    

   
   
   
   

    
    

     
     const QTextCodec *codec = QTextCodec::codecForName(
     
     "GBK");
     
     //声明为全局可以避免局部频繁出入栈
    
    
   
   

   
   

    
    

   
   
   
   

    
    
 
    
    
   
   

   
   

    
    

   
   
   
   

    
    

     
     -------------------------------------------------------
    
    
   
   

   
   

    
    

   
   
   
   

    
    
 
    
    
   
   

   
   

    
    

   
   
   
   

    
    

     
     另一个文件中：
    
    
   
   

   
   

    
    

   
   
   
   

    
    
 
    
    
   
   

   
   

    
    

   
   
   
   

    
    

     
     #include <comfunc_qt.h>
    
    
   
   

   
   

    
    

   
   
   
   

    
    
 
    
    
   
   

   
   

    
    

   
   
   
   

    
    

     
     extern 
     
     const QTextCodec *codec;
    
    
   
   

   
   

    
    

   
   
   
   

    
    
 
    
    
   
   

   
   

    
    

   
   
   
   

    
    

     
     #define dy_tr(...)   codec->toUnicode(__VA_ARGS__)  //dynamic trans
    
    
   
   

   
   

    
    

   
   
   
   

    
    

     
     //dy_tr可以带1或2个形参，返回值为QString
    
    
   
   
 
 

 
 

   
   

    
    

   
   
   
   

    
    

     
     上面封装为宏，使用了extern，密封性不好，因此，也可封装为函数
    
    
   
   

   
   

    
    

   
   
   
   

    
    
 
    
    
   
   

   
   

    
    

   
   
   
   

    
    
 
    
    
   
   

   
   

    
    

   
   
   
   

    
    
 
    
    
   
   

   
   

    
    

   
   
   
   

    
    
 
    
    
   
   
 
 

方法三：

最简洁的方法：

将char* 传给QString时，同时告诉QString自己的编码是什么：

就像下面的函数一样，QString的成员函数知道按照何种编码来处理 C 字符串

QString QString::fromAscii ( const char * str, int size = -1 )
QString QString::fromLatin1 ( const char * str, int size = -1 ) 
QString QString::fromLocal8Bit ( const char * str, int size = -1 )
QString QString::fromUtf8 ( const char * str, int size = -1 )

单QString 只提供了这几个成员函数，远远满足不了大家的需求，比如，在简体中文Windows下，local8Bit是GBK，可是有一个char串是 BIG5 或 Latin-2怎么办？

那就动用强大的QTextCodec吧，首先QTextCodec肯定知道自己所负责的编码的，然后你把一个char串送给它，它就能正确将其转成Unicode了。

QString QTextCodec::toUnicode ( const char * chars ) const

可是这个调用太麻烦了，我就想直接

QString a= str;

或

QString a(str);

这样用怎么办？

这样一来肯定没办法同时告诉 QString 你的str是何种编码了，只能通过其他方式了。这也就是开头提到的

QTextCodec::setCodecForCStrings(QTextCodec::codecForName("GBK"));
QTextCodec::setCodecForCStrings(QTextCodec::codecForName("UTF-8"));

设置QString默认采用的编码。而究竟采用哪一个，一般来说就是源代码是GBK，就用GBK，源代码是UTF-8就用UTF-8。但有一个例外，如果你保存成了带BOM的UTF-8而且用的微软的cl编译器，此时仍是GBK。