C++控制台UTF-16字符输出排版错位问题求助

核心问题根源 #

控制台字符错位的本质是非等宽字体导致字符宽度不一致，UTF-16本身不会直接引发这个问题——只要使用支持UTF-16的等宽字体，就能保证每个字符占据相同的单元格宽度，自然不会错位。你之前用CONSOLE_FONT_INFOEX无效，大概率是参数设置错误，而非UTF-16兼容问题。

解决方案1：强制使用等宽UTF-16字体 #

这是最直接的解决方法，以下是正确的字体设置代码：

#include <windows.h>
#include <iostream>

int main() {
    // 获取控制台句柄
    HANDLE hConsole = GetStdHandle(STD_OUTPUT_HANDLE);
    CONSOLE_FONT_INFOEX cfi{}; // 初始化结构体
    cfi.cbSize = sizeof(CONSOLE_FONT_INFOEX); // 必须设置结构体大小
    
    // 可选：获取当前字体信息作为基础修改
    GetCurrentConsoleFontEx(hConsole, FALSE, &cfi);
    
    // 设置为支持UTF-16的等宽字体（比如Consolas、JetBrains Mono、Noto Sans Mono CJK SC）
    wcscpy_s(cfi.FaceName, L"Consolas");
    cfi.dwFontSize.Y = 16; // 字体高度，宽度设为0让系统自动匹配等宽
    cfi.dwFontSize.X = 0;
    cfi.FontWeight = FW_NORMAL;
    
    // 应用字体设置
    if (!SetCurrentConsoleFontEx(hConsole, FALSE, &cfi)) {
        // 处理设置失败（比如字体未安装）
        std::cerr << "字体设置失败，错误码：" << GetLastError() << std::endl;
    }
    
    // 测试UTF-16字符输出
    std::wcout << L"█▓▒░abc123测试字符" << std::endl;
    return 0;
}

关键注意点：

• 必须初始化cbSize为结构体大小，否则SetCurrentConsoleFontEx会失败
• 选择的字体必须是系统已安装的等宽字体，且支持UTF-16字符集
• 确保控制台代码页正确：执行SetConsoleOutputCP(CP_UTF16)或在控制台属性中设置UTF-16编码

解决方案2：手动计算字符宽度并补位 #

如果必须使用非等宽字体，可以通过Windows API获取每个字符的实际宽度，手动填充空格对齐：

#include <windows.h>
#include <iostream>
#include <cstring>

int main() {
    HWND consoleWnd = GetConsoleWindow();
    HDC hdc = GetDC(consoleWnd);
    
    // 选一个基准字符（比如英文字母）的宽度作为标准
    int baseWidth = GetCharWidth32W(hdc, L'a', 1);
    const wchar_t* levelText = L"█▓▒░关卡▓▒░abc";
    
    for (size_t i = 0; i < wcslen(levelText); ++i) {
        wchar_t c = levelText[i];
        int charWidth = GetCharWidth32W(hdc, &c, 1);
        
        // 输出当前字符
        std::wcout << c;
        
        // 计算需要补充的空格数（按基准宽度对齐）
        int spaceCount = (baseWidth - charWidth + baseWidth - 1) / baseWidth;
        for (int j = 0; j < spaceCount; ++j) {
            std::wcout << L' ';
        }
    }
    std::wcout << std::endl;
    
    ReleaseDC(consoleWnd, hdc);
    return 0;
}

额外排查点 #

• 检查控制台是否开启了自动缩放：右键控制台窗口→属性→布局，取消"自动调整窗口大小"，手动设置合适的缓冲区和窗口尺寸
• 避免混合使用ANSI和UTF-16输出：统一用wcout输出宽字符，不要和cout混用

内容的提问来源于stack exchange，提问作者00663