调用windows.h API调整控制台大小时窗口隐藏问题求助

核心错误点 #

• 函数调用顺序错误：Windows控制台要求先设置屏幕缓冲区大小，再调整窗口大小，原代码先调整窗口再修改缓冲区，当目标窗口尺寸大于当前默认缓冲区尺寸时，API调用会直接失败，引发窗口无响应、异常隐藏等问题。
• 缓冲区尺寸与窗口参数不匹配：原代码硬编码缓冲区为{100, 50}，如果传入的consoleWidth/consoleHeight加上起始坐标后超过缓冲区对应宽高，SetConsoleWindowInfo参数校验失败，会进一步触发异常。
• VSCode集成终端兼容性问题：VSCode的集成终端为伪终端实现，未完整支持Windows原生控制台API，部分API调用会出现无响应、无输出的情况，测试时建议使用系统原生cmd或PowerShell运行程序。

修复后代码 #

#include <windows.h>

void setConsole(short consolePos_X, short consolePos_Y, short consoleWidth, short consoleHeight){
    HANDLE wConsoleHandle = GetStdHandle(STD_OUTPUT_HANDLE);
    // 先设置缓冲区，保证缓冲区宽高大于等于窗口右下角坐标，预留冗余避免边界问题
    COORD buffSize = {
        consolePos_X + consoleWidth + 10,
        consolePos_Y + consoleHeight + 10
    };
    SetConsoleScreenBufferSize(wConsoleHandle, buffSize);
    
    // 缓冲区设置完成后再调整窗口大小，SMALL_RECT的Right、Bottom为闭区间，需减1避免尺寸溢出
    SMALL_RECT consoleWinSize = {
        consolePos_X,
        consolePos_Y,
        consolePos_X + consoleWidth - 1,
        consolePos_Y + consoleHeight - 1
    };
    SetConsoleWindowInfo(wConsoleHandle, TRUE, &consoleWinSize);
    
    SetConsoleTitle("Snake Game");
}

额外注意事项 #

• 可增加API返回值校验：SetConsoleScreenBufferSize、SetConsoleWindowInfo调用成功返回非0值，失败返回0，可配合GetLastError()获取错误码快速定位问题。
• 代码中传入的consolePos_X、consolePos_Y是控制台内容显示区域的坐标偏移，不是窗口在桌面的位置，如需调整窗口桌面位置需调用SetWindowPos API。

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