SetConsoleCtrlHandler 是 Windows 控制台程序响应关闭事件的唯一合法入口，必须在主线程 early 注册全局 C 调用约定函数，仅设原子标志并快速返回，严禁耗时操作或非异步信号安全调用。
不是可选功能，而是 Windows 控制台程序响应关闭（如点 ×、Ctrl+C、注销）的
唯一合法入口
。没调用它，就等于没装刹车——所有关闭操作都会直接终止进程，不给你任何清理机会。
HandlerRoutine 必须是全局自由函数，不能是类成员或 lambda
系统回调只接受 C 调用约定的
签名。类成员函数隐含
指针，lambda 默认捕获环境，两者都会导致注册静默失败（
返回
）。
常见错误：
把 handler 写成
，编译可能过，但运行时
返回
用
或 lambda 包装后强转为
，行为未定义，多数情况回调根本不会触发
正确写法只能是：
立即学习
“
C++免费学习笔记（深入）
”；
必须在主线程调用 SetConsoleCtrlHandler，且越早越好
控制台事件只投递到创建它的线程（通常是
所在线程）。若你在子线程里调用
，函数会返回
，且后续任何 Ctrl+C 或关闭操作都**完全静默**——你既收不到回调，也拦不住终止。
实操建议：
C知道
CSDN推出的一款AI技术问答工具
下载
在
开头第一行就调用：
立即检查返回值：
不要等到初始化完日志、网络、线程池后再注册——万一前面某步卡死，你就彻底失去拦截能力
CTRL_CLOSE_EVENT 的 5 秒窗口期很危险，别在里面做耗时操作
用户点 × 后，系统只给你的
最多约 5 秒完成清理并返回
。超时即强制终止，且不保证你的代码能跑完。
典型踩坑行为：
在 handler 里直接调用
、
—— 若文件系统忙或磁盘满，可能阻塞数秒
调用
等待子线程退出
用
/
输出日志 —— 控制台句柄此时可能已被系统标记为“即将销毁”，I/O 会崩溃或卡死
安全做法只有一条：handler 中只做三件事 —— 设原子标志、写少量内存日志（如用
）、返回
。真正的清理逻辑交给主循环检测
后执行。
跨平台信号处理不能靠 try/catch，Ctrl+C 和 C++ 异常完全无关
有人试图用
拦截 Ctrl+C，这注定失败。因为
在 Windows 是
，在 Linux/macOS 是
，二者都是操作系统级信号，和 C++ 的
/
机制物理隔离。
关键事实：
对
或
完全无感知
MSVC 的
+
是黑盒 hack，不可移植、不保证触发时机、且在多线程下极易出错
真正可靠的跨平台退出模型，是抽象一个
查询接口，底层分别用
（Windows）和
（POSIX）驱动
最易被忽略的一点：handler 函数内连
构造、
、
都不能用——它们不是异步信号安全函数。Windows 下连
都可能锁住 CRT 的内部 mutex，导致整个进程挂起。
SetConsoleCtrlHandlerBOOL WINAPI HandlerRoutine(DWORD dwCtrlType)thisSetConsoleCtrlHandlerFALSEMyClass::onCtrlGetLastError()ERROR_INVALID_PARAMETERstd::bindPHANDLER_ROUTINEvolatile std::atomic_bool g_shutdown_requested{false};
BOOL WINAPI ConsoleCtrlHandler(DWORD dwCtrlType) {
switch (dwCtrlType) {
case CTRL_C_EVENT:
case CTRL_CLOSE_EVENT:
case CTRL_LOGOFF_EVENT:
case CTRL_SHUTDOWN_EVENT:
g_shutdown_requested = true;
return TRUE; // 告诉系统：我已接管，别杀进程
default:
return FALSE; // 让默认处理器处理其他类型（如 CTRL_BREAK_EVENT）
}
}
main()SetConsoleCtrlHandlerFALSEmain()SetConsoleCtrlHandler(ConsoleCtrlHandler, TRUE)if (!SetConsoleCtrlHandler(...)) { DWORD err = GetLastError(); /* 处理错误 */ }HandlerRoutineTRUEfclose(fp)std::ofstream::close()WaitForSingleObjectprintfstd::coutWriteConsoleATRUEg_shutdown_requestedtry { while(running) { ... } } catch(...) { cleanup(); }Ctrl+CCTRL_C_EVENTSIGINTthrowcatchtry/catchSetConsoleCtrlHandlersigaction/EHscset_terminateshutdown_requested()SetConsoleCtrlHandlersigactionstd::stringnewmallocprintf