含window.h的C++程序修改控制台字体失败：SetCurrentConsoleFontEx问题排查

我希望在程序执行时修改控制台使用的字体，尝试使用SetCurrentConsoleFontEx函数但未达到预期效果。编写了如下setConsoleFont函数，但执行后后续cout输出的内容并未应用新的字体大小及属性，请问哪里出错了？

原代码：

void setConsoleFont() {
    CONSOLE_FONT_INFOEX consoleFontInfo = { 0 };
    consoleFontInfo.cbSize = sizeof(CONSOLE_FONT_INFOEX);
    consoleFontInfo.dwFontSize.X = 18;
    consoleFontInfo.dwFontSize.Y = 18;
    consoleFontInfo.FontWeight = FW_BOLD;
    consoleFontInfo.FontFamily = FF_MODERN;
    wcscpy_s(consoleFontInfo.FaceName, L"Courier Regular");
    consoleFontInfo.nFont = 0;
    HANDLE handle = GetStdHandle(STD_OUTPUT_HANDLE);
    if(handle != INVALID_HANDLE_VALUE)
        if (SetCurrentConsoleFontEx(GetStdHandle(STD_OUTPUT_HANDLE), true, &consoleFontInfo)) {
            cout << "Font Changed Successfuly\n";
        }
        else {
            cout << "FAIL!\n";
            cout << GetLastError();
        }
}

问题排查与修正方案 #

• 参数冲突：字体名称和粗细不匹配
  Courier Regular是常规字重字体，你却设置了FontWeight = FW_BOLD，系统找不到同时满足这两个条件的字体，直接导致修改失败。要么把字体名称改成Courier Bold，要么把FontWeight改为FW_NORMAL。

• 冗余操作：重复获取标准输出句柄
  代码中先获取了handle变量，但调用SetCurrentConsoleFontEx时又重新调用GetStdHandle，虽然不会直接报错，但属于无效冗余，且极端情况下可能出现句柄不一致问题，应直接复用已获取的handle。

• nFont参数设置错误
  nFont = 0会让系统尝试匹配你指定的字体属性，但如果没有完全匹配项，会 fallback 到默认字体。正确做法是先调用GetCurrentConsoleFontEx获取当前字体信息作为基础修改，避免参数不兼容。

• bMaximumWindow参数误用
  第二个参数设为true表示修改最大化窗口的字体，而非当前窗口的字体，这和你的需求不符，应改为false。

修正后的代码 #

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

void setConsoleFont() {
    CONSOLE_FONT_INFOEX consoleFontInfo = { 0 };
    consoleFontInfo.cbSize = sizeof(CONSOLE_FONT_INFOEX);
    
    HANDLE handle = GetStdHandle(STD_OUTPUT_HANDLE);
    if (handle == INVALID_HANDLE_VALUE) {
        std::cout << "获取控制台句柄失败！错误码：" << GetLastError() << std::endl;
        return;
    }

    // 先获取当前字体信息，避免系统版本导致的结构体参数不兼容
    if (!GetCurrentConsoleFontEx(handle, FALSE, &consoleFontInfo)) {
        std::cout << "获取当前字体信息失败！错误码：" << GetLastError() << std::endl;
        return;
    }

    // 修改目标字体属性
    consoleFontInfo.dwFontSize.X = 18;
    consoleFontInfo.dwFontSize.Y = 18;
    consoleFontInfo.FontWeight = FW_BOLD;
    consoleFontInfo.FontFamily = FF_MODERN;
    wcscpy_s(consoleFontInfo.FaceName, L"Courier Bold"); // 匹配粗体字重的字体名称

    if (SetCurrentConsoleFontEx(handle, FALSE, &consoleFontInfo)) {
        std::cout << "字体修改成功！\n";
    } else {
        std::cout << "字体修改失败！错误码：" << GetLastError() << std::endl;
    }
}

int main() {
    setConsoleFont();
    std::cout << "测试新字体输出内容\n";
    return 0;
}

额外说明 #

• 调用GetCurrentConsoleFontEx获取当前字体结构，能保证cbSize等基础参数与系统版本兼容，避免因结构体定义差异导致的参数错误。
• 如果修改后仍未生效，可通过GetLastError返回的错误码进一步排查：比如ERROR_INVALID_PARAMETER表示参数冲突，ERROR_NOT_SUPPORTED表示系统不支持该字体或属性。

内容的提问来源于stack exchange，提问作者Muhammad Mubashir Islam