Windows下PyQt5嵌入Boost Python的C++程序捕获Ctrl-C方法咨询

刚好之前折腾过类似的场景，Windows下的Ctrl-C处理逻辑和Linux完全不一样，得用系统API注册回调来捕获信号，再结合标志位让你的优化例程提前退出。下面是具体的实现步骤和代码示例：

Windows没有Unix系的SIGINT信号机制，得用SetConsoleCtrlHandler这个API注册一个回调函数，当用户按下Ctrl-C时触发回调，设置一个全局中断标志；然后让你的C++优化例程在循环里轮询这个标志，一旦检测到中断信号就提前退出并清理资源。

1. C++模块里实现中断捕获逻辑 #

首先在你的Boost Python封装代码里加入以下内容：

#include <windows.h>
#include <boost/python.hpp>

// 全局中断标志，用volatile确保编译器不会优化读取操作
volatile bool g_is_interrupted = false;

// Ctrl-C回调函数，Windows系统会在收到Ctrl-C时调用它
BOOL WINAPI ConsoleCtrlHandler(DWORD ctrl_type) {
    if (ctrl_type == CTRL_C_EVENT) {
        g_is_interrupted = true;
        return TRUE; // 告诉系统我们已经处理了这个事件
    }
    return FALSE;
}

// 初始化函数，注册中断回调
void init_interrupt_handler() {
    SetConsoleCtrlHandler(ConsoleCtrlHandler, TRUE);
}

// 你的优化例程示例
boost::python::object run_optimization() {
    g_is_interrupted = false; // 每次运行前重置标志
    const int max_iter = 1000000;

    for (int iter = 0; iter < max_iter; ++iter) {
        // 每轮迭代都检查中断标志
        if (g_is_interrupted) {
            // 先做资源清理（比如释放内存、关闭文件等）
            // 抛出Python的KeyboardInterrupt异常，让上层Python代码捕获
            PyErr_SetString(PyExc_KeyboardInterrupt, "Optimization interrupted by Ctrl-C");
            boost::python::throw_error_already_set();
        }

        // 这里写你的优化逻辑
        // ...
    }

    // 正常结束时返回结果
    return boost::python::object("Optimization converged successfully");
}

// Boost Python模块导出
BOOST_PYTHON_MODULE(your_cpp_module) {
    using namespace boost::python;
    def("init_interrupt_handler", init_interrupt_handler);
    def("run_optimization", run_optimization);
}

2. PyQt层的配合处理 #

注意不要在PyQt的UI线程里直接跑你的C优化例程——UI线程的事件循环可能会拦截Ctrl-C信号，导致C的回调函数收不到事件。所以要把优化任务放到单独的线程里执行：

import sys
import threading
from PyQt5.QtWidgets import (QApplication, QMainWindow, QPushButton, 
                             QTextEdit, QVBoxLayout, QWidget)
import your_cpp_module

class OptimizationWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.init_ui()
        # 初始化C++的中断处理回调
        your_cpp_module.init_interrupt_handler()

    def init_ui(self):
        self.setWindowTitle("Optimization Tool")
        central_widget = QWidget()
        layout = QVBoxLayout(central_widget)

        self.log_area = QTextEdit()
        self.log_area.setReadOnly(True)
        layout.addWidget(self.log_area)

        self.start_btn = QPushButton("Start Optimization")
        self.start_btn.clicked.connect(self.launch_optimization)
        layout.addWidget(self.start_btn)

        self.setCentralWidget(central_widget)
        self.resize(600, 400)

    def launch_optimization(self):
        # 把优化任务放到单独线程，避免阻塞UI
        def run_task():
            try:
                result = your_cpp_module.run_optimization()
                self.log_area.append(f"✅ {result}")
            except KeyboardInterrupt:
                self.log_area.append(f"⚠️ Optimization interrupted by Ctrl-C")
            except Exception as e:
                self.log_area.append(f"❌ Error: {str(e)}")
        
        optimization_thread = threading.Thread(target=run_task)
        optimization_thread.start()

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = OptimizationWindow()
    window.show()
    sys.exit(app.exec_())

关键注意事项 #

• volatile关键字：必须给中断标志加上volatile，防止编译器把它优化成寄存器变量，导致循环里读不到最新的中断状态。
• 回调函数不要做复杂操作：Windows的Ctrl-C回调是在系统线程里执行的，不能直接操作Python对象或者Boost Python API（没有正确的GIL上下文），只设置标志位是最安全的。
• 线程隔离：一定要把优化任务从UI线程剥离，否则PyQt的事件循环会抢掉Ctrl-C信号，导致C++的回调无法触发。

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