Qt國際化最佳實踐：拒絕源碼硬編碼中文，善用Qt Linguist翻譯框架

反面教材：典型錯誤用法

// 錯誤示範
action->setText(tr("開始"));  // 源碼硬編碼中文

// main.cpp 設置編碼
QTextCodec *codec = QTextCodec::codecForName("GB2312");
QTextCodec::setCodecForLocale(codec);
QTextCodec::setCodecForCStrings(codec);
QTextCodec::setCodecForTr(codec);

三大致命缺陷

1. 編碼不兼容：GB2312源碼在UTF-8環境（如Ubuntu）打開顯示亂碼
2. 部署風險：目標機器無中文編碼支持時，程序無法正確運行/顯示
3. 忽視框架能力：Qt提供完善的Qt Linguist國際化工具鏈，卻未利用

標準國際化流程（三步走）

步驟1：源碼純英文 + tr()標記

// 正確做法
action->setText(tr("Start"));  // 英文鍵值 + tr()標記
label->setText(tr("User Name:"));

步驟2：Qt Linguist提取、翻譯、發布

• 運行 lupdate 提取所有 tr() 字符串生成 .ts 翻譯源文件
• 用 Qt Linguist 圖形界面編輯翻譯（支持多語言並行）
• 運行 lrelease 編譯生成二進制 .qm 翻譯包

步驟3：程序啟動加載翻譯包

QTranslator translator;
translator.load(":/i18n/myapp_zh_CN.qm");  // 從資源系統加載
qApp->installTranslator(&translator);

核心優勢

• 源碼純ASCII：跨平台、跨編輯器零亂碼風險
• 運行時動態切換：無需重編譯即可支持新語言
• 專業翻譯協作：非技術人員可直接用Linguist翻譯
• 上下文區分：同一英文在不同類中可翻譯為不同目標語

參考資源

• DevBean《Qt學習之路(33): 國際化(上)》(下)
• dbzhang800《Qt國際化源碼含中文時的點滴分析》

結語

堅決抵制源碼中出現中文（含tr包裹中文）。遵循Qt設計哲學，用專業工具做專業的事，才是商業級Qt開發的正確姿態。