QT6.9+VS2022项目中Umlauts显示异常及编译错误问题

• VS2022默认将源文件保存为GBK编码（Windows本地编码），而QT6的字符串处理逻辑基于UTF-8，编码不匹配导致Umlauts这类特殊字符解析异常。
• QStringLiteral是编译期宏，依赖编译器对源文件编码的解析，若源文件不是UTF-8带BOM格式，编译器无法识别Umlauts字符，直接导致字符丢失。
• QString::fromUtf8失效的核心原因是：源文件本身不是UTF-8编码，传入的字节序列并非真正的UTF-8格式，转换后自然还是乱码。
• 单个Umlauts字符触发编译错误，是因为编译器将其视为多字节GBK字符，而单个字符字面量要求单字节或宽字符，编码不兼容引发错误。

1. 统一源文件编码为UTF-8带BOM #

• 打开目标源文件，点击VS2022顶部菜单「文件」→「高级保存选项」，编码选择「Unicode (UTF-8 带签名) - 代码页 65001」，保存文件。
• 设置默认编码：依次打开「工具」→「选项」→「文本编辑器」→「所有语言」→「常规」，勾选「UTF-8 带签名的编码保存所有文件」，后续新建文件自动沿用该编码。

2. 正确使用QT字符串宏 #

• 确保源文件是UTF-8带BOM后，直接用QStringLiteral包裹含Umlauts的字符串，这是QT推荐的高效写法：

  QMessageBox::information(nullptr, "提示", QStringLiteral("包含ä的测试文本"));
  

• 若需运行时动态转换，先保证源文件为UTF-8，再使用fromUtf8：

  QMessageBox::information(nullptr, "提示", QString::fromUtf8("包含ä的测试文本"));
  

3. 处理单个Umlauts字符 #

• 两种可行写法：

  // 方式1：使用宽字符字面量
  wchar_t umlautChar = L'ä';
  QString singleCharStr = QString(QChar(umlautChar));
  
  // 方式2：直接使用UTF-8转义序列
  QString singleCharStr = QStringLiteral("\xc3\xa4"); // ä对应的UTF-8十六进制转义
  

4. 项目级编码配置（可选） #

• 在QT项目的.pro文件中添加以下配置，强制项目使用UTF-8编码：

  CODECFORSRC = UTF-8
  CODECFORTR = UTF-8
  

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