原始碼編碼對編譯結果的影響：Windows 與 Linux 的差異分析

編碼與編譯的跨平台差異

原始碼檔案的編碼格式（UTF-8 或 ANSI）在不同作業系統下對編譯結果的影響截然不同，這是跨平台開發常遇到的坑。

實測結論

問題發現過程

使用 Source Insight 3.5 開啟專案時發現中文顯示亂碼，但 Notepad 開啟正常。經 UltraEdit 與 Beyond Compare 驗證，原檔案為 UTF-8 編碼，另存為 ANSI 後 Source Insight 即可正常顯示。這說明舊版 Source Insight 不支援 UTF-8 中文顯示。

Qt 專案實測

測試程式碼使用 QString::fromLocal8Bit 處理中文字串：

QPushButton hello(QString::fromLocal8Bit("世界您好!"));

ANSI 與 UTF-8 兩種編碼的源檔在 Windows 下編譯執行皆正常，二進位比較發現 UTF-8 版每個漢字多佔 1 位元組。但在 Linux 下編譯，UTF-8 版正常，ANSI 版亂碼。

核心原因分析

• Windows：編譯器（MSVC/MinGW）預設以系統當前代碼頁（如 CP936/GBK）解讀原始碼，ANSI 檔恰好符合；UTF-8 檔經編譯器內部轉換亦能正確處理。
• Linux：GCC 預設以 UTF-8 解讀原始碼，UTF-8 檔自然正確；ANSI 檔（實為 GBK/Big5 等）被誤判為 UTF-8 導致解碼錯誤。

最佳實踐建議

1. 統一使用 UTF-8 編碼儲存所有原始碼檔案，確保跨平台一致性。
2. 在專案建置系統（CMake/qmake）中明確指定原始碼編碼：add_compile_options(-finput-charset=UTF-8) (GCC) 或 /source-charset:utf-8 (MSVC)。
3. 避免在原始碼中直接寫入非 ASCII 字串，改用 QString::fromUtf8、tr() 或外部資源檔（.ts/.qm）管理多語言文字。
4. 團隊統一編輯器設定，強制存檔為 UTF-8（無 BOM）。