VS2022 + Qt5.9 中文乱码/项目设置utf-8编码

🛠️ 解决QT5.9 + VS2022中文乱码的全面方案

📁 1. 检查文件编码与编译器设置

确保源文件是 带BOM的UTF-8 编码对MSVC编译器很重要。VS2022默认可能使用本地编码（如GB2312）解析源文件，即使文件以UTF-8保存。

• 查看和设置文件编码：在VS2022中，可以通过 “文件” -> “高级保存选项” 来确认和设置当前文件的编码为 “Unicode (UTF-8 带签名) - 代码页 65001”。如果“文件”菜单中没有“高级保存选项”，可以通过 “工具” -> “自定义” -> “命令” -> “菜单栏” 选择“文件”，点击“添加命令”，在“文件”类别中找到并添加“高级保存选项”。
• 强制编译器使用UTF-8：在项目属性中设置编译器使用UTF-8编码。
  • 右键点击项目 -> “属性”。
  • 进入 “配置属性” -> “C/C++” -> “命令行”。
  • 在 “其他选项” 中添加 /utf-8。

⚙️ 2. 项目属性配置

在VS2022中配置项目属性，以确保从编译到链接各个环节都能正确处理UTF-8编码。

1. 右键单击你的Qt项目，选择 “属性”。
2. 在 “配置属性” -> “C/C++” -> “命令行” 的“其他选项”中，添加 /utf-8。
3. 确保你的项目配置文件（如 .vcxproj）中没有其他字符集相关的冲突设置。

🔧 3. 代码层面的修改

使用 QStringLiteral 宏

QStringLiteral 宏可以在编译期将字符串字面量转换为 QString 对象，并正确处理UTF-8编码，避免运行时转换开销和乱码问题。

// 修改前
QPushButton* button = new QPushButton(QString("点击我"), this);

// 修改后
QPushButton* button = new QPushButton(QStringLiteral("点击我"), this);

使用 tr() 函数进行国际化

对于用户界面中的字符串，建议使用 tr() 函数，它不仅可以标记需要翻译的字符串，也在一定程度上有助于Qt的字符串处理系统正确识别编码。

QMessageBox::information(this, QStringLiteral("标题"), tr("你点击了按钮"));
// 注意：tr() 函数本身通常用于国际化，其源字符串也需要确保编码正确。
// 如果使用 tr(), 对应的字符串应出现在 .ts 翻译文件中，并由 lrelease 工具处理。

显式指定字符串编码

如果以上方法仍有问题，可以尝试使用 QString::fromUtf8() 进行显式转换。

QPushButton* button = new QPushButton(QString::fromUtf8("点击我"), this);
...
QMessageBox::information(this, QString::fromUtf8("标题"), QString::fromUtf8("你点击了按钮"));

🌐 4. 设置应用程序默认编码

在 main 函数中，设置应用程序的默认编码为 UTF-8。请注意，在 Qt5 中，QTextCodec::setCodecForLocale 等函数已被弃用，但在某些情况下，明确设置编码可能仍有帮助。

#include <QApplication>
#include <QTextCodec> // 如果使用Qt5，注意某些函数已弃用

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

    // 设置应用程序默认使用 UTF-8 编码
    // 在Qt5.9中，以下函数可能可用，但请注意Qt5中这些函数已标记为废弃
    // 在Qt6中，这些函数已被移除
#if QT_VERSION <= QT_VERSION_CHECK(6,0,0)
    QTextCodec *codec = QTextCodec::codecForName("UTF-8");
    QTextCodec::setCodecForLocale(codec);
    // 注意：setCodecForCStrings 和 setCodecForTr 在 Qt5 中已移除。
#endif

    // ... 你的其他代码 ...

    return a.exec();
}

重要提醒：QTextCodec::setCodecForLocale 在 Qt5 中已废弃，且在 Qt6 中完全移除。对于新项目，建议优先采用前述方法一和方法二。

📝 用户代码修改示例

根据以上建议，你的代码可以修改为：

// 根据需要包含头文件，例如可能需要 #include <QTextCodec>

QPushButton* button = new QPushButton(QStringLiteral("点击我"), this);
button->setGeometry(100, 100, 100, 30);
connect(button, &QPushButton::clicked, [=]() {
    QMessageBox::information(this, QStringLiteral("标题"), QStringLiteral("你点击了按钮"));
    // 如果为了国际化，并且已经配置好翻译系统，也可以使用 tr()
    // QMessageBox::information(this, tr("Title"), tr("You clicked the button."));
});

💎 核心解决思路汇总

希望这些方法能帮助你解决中文乱码问题。如果在尝试后问题依旧，或者你在实践中遇到了其他情况，欢迎随时告诉我。

VS 里边安装插件【Force UTF8】拓展

【无BOM版（推荐）】
https://marketplace.visualstudio.com/items?itemName=hbuexinxin.Fo

rceUTF8NoBOM
【带BOM版】
https://marketplace.visualstudio.com/items?itemName=jz5.ForceUTF8withBOM-18593