setconsoledisplaymode仅在windows 10 1809+原生conhost中支持全屏独占模式，不适用于windows terminal、wsl、远程桌面或无控制台所有权的进程；mode命令仅调整窗口尺寸，无法实现显卡级全屏。
Windows平台下用SetConsoleDisplayMode切换控制台显示模式
只有 Windows 10 1809 及以上版本才支持真正意义上的“全屏独占模式”，且必须运行在原生控制台（conhost.exe）中，不能在 Windows Terminal 或 VS Code 终端里生效。SetConsoleDisplayMode 是唯一能切换到“全屏”或“窗口化”的 API，但它不适用于 WSL、远程桌面会话或以管理员权限启动但未获取控制台所有权的进程。
- 调用前必须先用
GetStdHandle(STD_OUTPUT_HANDLE)获取有效句柄 - 全屏模式（
CONSOLE_FULLSCREEN_MODE）会隐藏任务栏、禁用 Alt+Tab，但无法指定分辨率，完全由系统决定 - 窗口模式（
CONSOLE_WINDOWED_MODE）是安全回退选项，失败时应主动 fallback - 返回
FALSE并且GetLastError()返回ERROR_INVALID_FUNCTION表示当前环境不支持（比如 Windows Terminal）
为什么system("mode con: cols=120 lines=30")只能改大小，不能切全屏
mode 命令本质是调整控制台缓冲区和窗口尺寸，它操作的是 CONSOLE_SCREEN_BUFFER_INFO 中的 dwSize 和 srWindow 字段，属于“窗口内缩放”，和显示模式无关。它在任何终端里都可用，但永远无法触发显卡级全屏——那需要绕过桌面窗口管理器，而这正是 SetConsoleDisplayMode 的职责所在。
-
mode con: cols=120 lines=30实际调用的是内部SetConsoleScreenBufferInfoEx，仅影响字符网格密度 - 如果控制台已处于全屏模式，
mode仍可修改行列数，但退出全屏后会恢复原始设置 - 在 Windows Terminal 中执行
mode会静默失败，无报错也不生效
跨平台兼容性差，别指望 Linux/macOS 有对应方案
Linux 和 macOS 的终端（如 xterm、iTerm2、GNOME Terminal）根本不提供“控制台显示模式”这一抽象概念——它们只是 X11 / Wayland / Quartz 下的普通 GUI 窗口。所谓“全屏”是窗口管理器行为（例如 xdotool windowactivate --sync $WINID && xdotool key F11），与进程自身无关，C++ 代码无法直接控制。
- POSIX 系统下没有等价于
SetConsoleDisplayMode的标准接口 - 试图用 ANSI 转义序列（如
\033[?1049h）只是启用备用缓冲区，不是显示模式切换 - 若真需要统一行为，只能放弃原生控制台，转用 SDL、Qt 或 GLFW 创建独立窗口来模拟终端
实际使用时最常踩的坑：权限与所有权问题
即使系统版本达标，SetConsoleDisplayMode 也会因控制台归属权问题失败。典型场景是：从 PowerShell 或 CMD 启动程序时，控制台归父进程所有；而从 IDE（如 Visual Studio）直接运行时，IDE 可能接管了控制台句柄，导致调用返回 ERROR_ACCESS_DENIED。
- 确保程序是控制台会话的“前台进程”，可用
GetForegroundWindow()+GetConsoleWindow()对比验证 - 避免在调试器附加状态下调用——VS 默认启用“控制台窗口重定向”，此时
GetStdHandle返回的句柄无效 - 全屏模式下按
Alt+Enter可手动切回窗口模式，但代码无法监听该事件，需自行处理WM_SIZE消息做响应
真正的难点不在调用 API，而在判断当前是否具备切换条件——版本、句柄、会话类型、前台状态，缺一不可。漏掉任一检查，函数就静默失败。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
