QT中显示中文的几种方法及注意事项

一.概述

   Qt默认使用Unicode编码，而中文在文件或字符串中可能以GBK、GB2312、GB18030或UTF-8等多种编码形式存在，因此需要进行适当的转换或设置以确保中文能够正确显示。

以下是几种常见的Qt显示中文的方法.

二.QT中显示中文方法

1.使用QString::fromLocal8Bit方法

  该方法可以将本地编码（如GBK）的字符串转换成Unicode编码的QString对象，进而在Qt界面中显示。

示例代码如下：

ui->label->setText(QString::fromLocal8Bit("你好"));

注意：fromLocal8Bit方法假定传入的字符串是以系统本地编码（在Windows上通常是GBK或GB2312）编码的。如果系统或文件编码与此不符，可能会导致乱码。

2.使用QTextCodec类

QTextCodec类提供了更灵活的编码转换功能，可以全局或局部地设置字符集编码，并提供静态方法进行编码转换。

示例代码如下：

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

QString str = codec->toUnicode("你好");  

ui->label->setText(str);

注意：

使用QTextCodec需要添加头文件：#include <QTextCodec>

同时在.pro文件中要添加：greaterThan(QT_MAJOR_VERSION, 5): QT += core5compat

应用场景：

在串口和网络通讯中接收的数据都是QByteArray格式，有时时需要转换为QString来显示到文本框中，如果对方送过来的数据是GBK编码的汉字，就需要用QTextCodec转换。

示例：

    if(serial.bytesAvailable() > 0)  

    {

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

        QByteArray recv = serial.readAll();

        QString recv_string = codec->toUnicode(recv);

        ui->ReceiveTextEdit->append(recv_string);

    }

3.使用QStringLiteral宏

  QStringLiteral宏可以在编译时将字符串字面量转换为一个QString对象，并且由于这种转换是在编译时完成的，因此它比运行时转换更高效。如果源文件使用UTF-8编码，则可以直接使用QStringLiteral来显示中文。

示例代码如下：

ui->label->setText(QStringLiteral("你好"));

注意：这种方法要求源文件本身以UTF-8编码保存。

4.在.cpp文件中指定字符集

  对于某些编译器和环境，可以在.cpp文件的开头加入特定的指令来指定源文件使用的字符集。例如，使用GCC编译器时，可以在.cpp文件中加入以下指令来指定使用UTF-8编码：

#pragma execution_character_set("utf-8")

然后，就可以直接在源文件中使用UTF-8编码的字符串变量了。

三.总结

Qt显示中文的方法多种多样，可以根据具体情况选择最适合的方法。在实际开发中，建议优先考虑使用UTF-8编码和QStringLiteral宏，因为它们能够提供更好的兼容性和效率。同时，也要确保所使用的字体支持中文显示。