C++中设置控制台12x8点阵字体失败，如何解决？

阿华AIGC实验室

2026-5-26

解决C++控制台设置Terminal 12x8点阵字体失败的问题

我之前也踩过这个控制台字体设置的坑！你遇到的问题本质是：Terminal字体本身并不支持12x8的点阵尺寸，Windows控制台会自动把你指定的尺寸替换成该字体最接近的可用选项，也就是你看到的12x5。

为什么会这样？

Windows控制台的字体（尤其是点阵类的Terminal）并不是支持任意自定义尺寸的，每个字体都有一套预定义的可用点阵规格。Terminal字体的12像素高度对应的默认宽度就是5像素，所以当你强行设置dwFontSize.X=8时，系统找不到匹配的规格，就会 fallback 到最接近的12x5。

解决步骤

1. 先枚举控制台支持的所有字体规格

首先你需要确认系统里到底有没有你要的12x8点阵的Terminal字体（或者有没有其他点阵字体支持这个尺寸）。可以用EnumConsoleFontsEx函数枚举所有可用字体：

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

BOOL CALLBACK EnumFontsCallback(CONSOLE_FONT_INFOEX* fontInfo, LPARAM param) {
    auto& fonts = *reinterpret_cast<std::vector<CONSOLE_FONT_INFOEX>*>(param);
    fonts.push_back(*fontInfo);
    return TRUE;
}

int main() {
    HANDLE hConsole = GetStdHandle(STD_OUTPUT_HANDLE);
    std::vector<CONSOLE_FONT_INFOEX> availableFonts;

    CONSOLE_FONT_INFOEX queryFont = {0};
    queryFont.cbSize = sizeof(CONSOLE_FONT_INFOEX);
    EnumConsoleFontsEx(hConsole, &queryFont, EnumFontsCallback, reinterpret_cast<LPARAM>(&availableFonts));

    // 打印所有Terminal字体的可用尺寸
    wprintf(L"Available Terminal fonts:\n");
    for (const auto& font : availableFonts) {
        if (wcscmp(font.FaceName, L"Terminal") == 0) {
            wprintf(L"  Size: %dx%d\n", font.dwFontSize.X, font.dwFontSize.Y);
        }
    }

    return 0;
}

运行这段代码后，你就能看到Terminal字体实际支持哪些尺寸了——大概率不会有12x8的选项。

2. 正确设置目标字体

如果你一定要12x8的点阵字体，有两个选择：

换一个支持该尺寸的点阵字体（比如Fixedsys，你可以在枚举结果里找）
如果坚持用Terminal，就选择它支持的尺寸

下面是一段可以精准设置字体的代码，它会先查找你要的字体规格，找到后再设置：

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

BOOL CALLBACK FindTargetFont(CONSOLE_FONT_INFOEX* fontInfo, LPARAM param) {
    auto& targetFont = *reinterpret_cast<CONSOLE_FONT_INFOEX*>(param);
    // 匹配字体名称和目标尺寸
    if (wcscmp(fontInfo->FaceName, L"Terminal") == 0 
        && fontInfo->dwFontSize.X == 8 
        && fontInfo->dwFontSize.Y == 12) {
        targetFont = *fontInfo;
        return FALSE; // 找到后停止枚举
    }
    return TRUE;
}

int main() {
    HANDLE hConsole = GetStdHandle(STD_OUTPUT_HANDLE);
    CONSOLE_FONT_INFOEX targetFont = {0};
    targetFont.cbSize = sizeof(CONSOLE_FONT_INFOEX);

    // 查找目标字体
    BOOL found = EnumConsoleFontsEx(hConsole, &targetFont, FindTargetFont, reinterpret_cast<LPARAM>(&targetFont));

    if (!found) {
        // 如果没找到，打印可用的Terminal字体
        wprintf(L"Terminal 8x12 not found! Available Terminal sizes:\n");
        EnumConsoleFontsEx(hConsole, &targetFont, [](CONSOLE_FONT_INFOEX* info, LPARAM) -> BOOL {
            if (wcscmp(info->FaceName, L"Terminal") == 0) {
                wprintf(L"  %dx%d\n", info->dwFontSize.X, info->dwFontSize.Y);
            }
            return TRUE;
        }, 0);
    } else {
        // 设置找到的字体
        SetCurrentConsoleFontEx(hConsole, FALSE, &targetFont);
        wprintf(L"Successfully set font to Terminal 8x12!\n");
    }

    return 0;
}