Windows下Qt UTF-16输出在CMD/PowerShell显示问号问题求助

一、修复QCommandLineParser的西里尔文显示问题 #

QCommandLineParser的帮助信息默认依赖Qt的日志输出机制（如qInfo），所以解决底层的控制台编码适配即可修复它的显示问题，无需修改QCommandLineParser核心逻辑。

二、控制台正常显示西里尔文的具体方案 #

方案1：适配UTF-8编码（支持Win10 1903+/Win11） #

1. 切换控制台代码页为UTF-8：

   chcp 65001
   

2. 修改Qt输出逻辑，将字符串转为UTF-8字节流输出，替代原qInfo("%ls", ...)方式：

   #include "QtCore/QtGlobal"
   #include "QtCore/QString"
   #include <iostream>
   
   int main()
   {
       // 直接输出UTF-8字面量
       std::cout << u8"Привет" << std::endl;
       // 处理QString：转UTF-8后输出
       QString msg = u"Привет";
       std::cout << msg.toUtf8().constData() << std::endl;
       return 0;
   }
   

3. 针对QCommandLineParser，通过自定义日志处理器转UTF-8输出：

   #include <QtCore/QCommandLineParser>
   #include <QtCore/QCoreApplication>
   #include <iostream>
   
   void messageHandler(QtMsgType type, const QMessageLogContext& context, const QString& msg)
   {
       Q_UNUSED(type);
       Q_UNUSED(context);
       std::cout << msg.toUtf8().constData() << std::endl;
   }
   
   int main(int argc, char *argv[])
   {
       QCoreApplication app(argc, argv);
       // 替换Qt默认日志输出逻辑
       qInstallMessageHandler(messageHandler);
   
       QCommandLineParser parser;
       parser.setApplicationDescription(u"Привет это тест"); // 西里尔文描述
       parser.addHelpOption();
       parser.process(app);
   
       return app.exec();
   }
   

方案2：调用Windows宽字符API（兼容旧版Windows） #

如果需要支持Win10 1903之前的系统，直接用Windows原生API输出宽字符：

#include "QtCore/QString"
#include <windows.h>

int main()
{
    QString msg = u"Привет";
    HANDLE hConsole = GetStdHandle(STD_OUTPUT_HANDLE);
    WriteConsoleW(hConsole, msg.utf16(), msg.length(), nullptr, nullptr);
    return 0;
}

针对QCommandLineParser，同样可以在自定义日志处理器中调用WriteConsoleW输出宽字符内容。

关键注意事项 #

• 控制台字体需支持西里尔文：确保字体设置为Consolas或Lucida Console。
• 编译编码设置：MSVC编译时添加/utf-8选项，避免字符串字面量编码错误。

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