如何在MFC程序显示前将UTF-8/ASCII文本文件转换为UTF-16？

刚好在MFC项目里处理过不少编码转换的需求，给你几个靠谱的实现方式，都是实际跑通的：

一、用Windows原生API MultiByteToWideChar（最通用） #

这是最基础也最灵活的方法，不管是ASCII还是UTF-8都能处理（ASCII是UTF-8的子集，用CP_UTF8参数也能正常转换）。

步骤说明： #

1. 先调用一次MultiByteToWideChar，传入CP_UTF8和待转换的字节数组，缓冲区设为NULL，获取需要的宽字符长度。
2. 分配足够的宽字符缓冲区（注意要加1，因为结尾需要\0）。
3. 再次调用MultiByteToWideChar完成转换。

代码示例： #

// 假设已经读取到UTF-8/ASCII的字节数据，存在CStringA strAnsi里
CStringW strUnicode;

int nLen = MultiByteToWideChar(CP_UTF8, 0, strAnsi, strAnsi.GetLength(), NULL, 0);
if (nLen > 0) {
    wchar_t* pBuf = new wchar_t[nLen + 1];
    MultiByteToWideChar(CP_UTF8, 0, strAnsi, strAnsi.GetLength(), pBuf, nLen);
    pBuf[nLen] = L'\0'; // 手动加结束符
    strUnicode = pBuf;
    delete[] pBuf;
} else {
    // 转换失败，处理错误，比如GetLastError()
    AfxMessageBox(_T("编码转换失败"));
}

二、封装成MFC风格的辅助函数 #

为了方便复用，你可以把转换逻辑封装成一个全局函数，直接从CStringA转CStringW：

CStringW Utf8ToUnicode(const CStringA& strUtf8) {
    if (strUtf8.IsEmpty()) return L"";
    
    int nLen = MultiByteToWideChar(CP_UTF8, 0, strUtf8, strUtf8.GetLength(), NULL, 0);
    if (nLen <= 0) return L"";
    
    CStringW strUnicode;
    strUnicode.GetBufferSetLength(nLen);
    MultiByteToWideChar(CP_UTF8, 0, strUtf8, strUtf8.GetLength(), strUnicode.GetBuffer(), nLen);
    strUnicode.ReleaseBuffer();
    
    return strUnicode;
}

调用的时候直接CStringW str = Utf8ToUnicode(yourUtf8String);就行，ASCII文本也能直接用这个函数。

三、处理带BOM的UTF-8文件 #

如果你的UTF-8文件带BOM（开头三个字节是0xEF 0xBB 0xBF），读取的时候要先跳过这三个字节，否则转换出来的字符串开头会有乱码。比如读取文件时：

CFile file;
if (file.Open(_T("test.txt"), CFile::modeRead | CFile::typeBinary)) {
    DWORD dwSize = file.GetLength();
    if (dwSize >= 3) {
        BYTE bom[3];
        file.Read(bom, 3);
        if (!(bom[0] == 0xEF && bom[1] == 0xBB && bom[2] == 0xBF)) {
            // 不是UTF-8 BOM，把指针移回开头
            file.SeekToBegin();
        }
    }
    // 读取剩余内容
    CStringA strContent;
    strContent.GetBufferSetLength(dwSize);
    file.Read(strContent.GetBuffer(), dwSize - file.GetPosition());
    strContent.ReleaseBuffer();
    file.Close();
    
    // 转换为UTF-16
    CStringW strUnicode = Utf8ToUnicode(strContent);
    // 显示到控件，比如SetWindowText(strUnicode);
}

踩坑提醒 #

• 不要用CP_ACP代替CP_UTF8，除非你确定文本是系统默认编码，否则UTF-8的中文会转成乱码。
• 转换前一定要检查MultiByteToWideChar的返回值，如果是0，说明转换出错，要调用GetLastError()排查问题。
• MFC的控件（比如CEdit、CStatic）默认是Unicode模式（如果项目是Unicode编译），直接用SetWindowTextW或者CStringW就能正常显示。

内容的提问来源于stack exchange，提问作者L1-Cache