🛠? 解決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."));
});

💎 核心解決思路匯總

環節	推薦設置	注意事項
文件編碼	帶BOM的UTF-8	在VS2022中通過“高級保存選項”設置。
編譯器設置	項目屬性 -> C/C++ -> 命令行 -> 其他選項：/utf-8	確保編譯器正確理解源文件編碼。
字符串處理	使用 QStringLiteral 宏	編譯期創建QString，避免亂碼。
國際化	使用 tr() 函數	方便后續國際化，并可能減少編碼問題。
應用程序編碼	QTextCodec::setCodecForLocale (Qt5)	注意：Qt5中已廢棄，Qt6中已移除。僅在必要時使用，并注意兼容性。

希望這些方法能幫助你解決中文亂碼問題。如果在嘗試后問題依舊，或者你在實踐中遇到了其他情況，歡迎隨時告訴我。

VS 里邊安裝插件【Force UTF8】拓展

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

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