背景知識

Windows 內核自 NT 系統起原生使用 Unicode (UTF-16)。ANSI 版本 API 實際上是系統提供的薄封裝：將參數轉換為 Unicode 再調用寬字符版本，返回結果再轉回 ANSI。這層轉換帶來效能損耗、字符集相容性問題（DBCS 雙位元組字符集導致字符邊界判斷困難）以及跨語系顯示錯亂。

現代 Windows 應用強烈建議純 Unicode 開發，僅在對接舊式 ANSI 組件、讀寫特定編碼文件、網路協議要求時才進行邊界轉換。

建立 Unicode 專案 (Visual Studio)

1. 專案屬性 → C/C++ → 預處理器 → 預處理器定義：移除 _MBCS，添加 UNICODE、_UNICODE。
2. 專案屬性 → 連結器 → 系統 → 入口點：設為 wWinMainCRTStartup（GUI）或 wmainCRTStartup（控制台）。
3. 字符集設定：VS 2005+ 直接在「專案屬性 → 一般 → 字符集」選「使用 Unicode 字符集」。

程式碼層面三大鐵律

_T() 宏定義：

#ifdef UNICODE
#define _T(x) L##x
#else
#define _T(x) x
#endif

常用類型對照表

字符編碼轉換實戰

Unicode ↔ ANSI (當前代碼頁)

// Unicode → ANSI
std::string toAnsi(const std::wstring& wstr, UINT codePage = CP_ACP) {
    if (wstr.empty()) return "";
    int len = WideCharToMultiByte(codePage, 0, wstr.c_str(), -1, nullptr, 0, nullptr, nullptr);
    std::string str(len - 1, '\0');
    WideCharToMultiByte(codePage, 0, wstr.c_str(), -1, &str[0], len, nullptr, nullptr);
    return str;
}

// ANSI → Unicode
std::wstring toUnicode(const std::string& str, UINT codePage = CP_ACP) {
    if (str.empty()) return L"";
    int len = MultiByteToWideChar(codePage, 0, str.c_str(), -1, nullptr, 0);
    std::wstring wstr(len - 1, L'\0');
    MultiByteToWideChar(codePage, 0, str.c_str(), -1, &wstr[0], len);
    return wstr;
}

// UTF-8 專用 (CP_UTF8)
std::string toUtf8(const std::wstring& wstr) { return toAnsi(wstr, CP_UTF8); }
std::wstring fromUtf8(const std::string& str) { return toUnicode(str, CP_UTF8); }

資源字符串特殊規則

• 資源編譯器總是將字符串表、對話框模板、選單資源以 Unicode 存入 EXE/DLL。
• 無論專案字符集設定如何，LoadString、GetDlgItemText 等資源 API 返回 Unicode 字符串。
• 直接賦值 CString str = _T("中文") 無需轉換，編譯器自動處理。

常見坑點與避坑指南

現代 C++ 最佳實踐 (C++17/20)

// 內部統一使用 UTF-8 std::string (或 std::u8string C++20)
std::string internal_utf8 = u8"中文"; // C++20 char8_t

// Windows API 邊界轉換封裝
namespace win32 {
    std::wstring toWide(const std::string& utf8) {
        return fromUtf8(utf8); // 內部實現
    }
    std::string toUtf8(const std::wstring& wide) {
        return toUtf8(wide);
    }
}

// 文件 I/O 使用 std::filesystem::path (原生支援 Unicode 路徑)
std::filesystem::path p = LR"(\\?\C:\Very\Long\Path\中文.txt)";
std::ofstream ofs(p, std::ios::binary); // C++17 支援宽字符路徑

總結

1. 專案全局 Unicode：移除 _MBCS，定義 UNICODE/_UNICODE，設定入口點。
2. 代碼全面 TCHAR 化：類型用 TCHAR，字面量用 _T()，函數用 _tcs* 族。
3. 邊界統一轉換：文件、網路、舊組件交互處統一 UTF-8 ↔ UTF-16 轉換。
4. 資源無需轉換：資源編譯器已保證 Unicode 存儲。
5. 現代化演進：內部採用 UTF-8 std::string，配合 std::filesystem、char8_t、std::format (C++20) 徹底擺脫 TCHAR 宏依賴。