Cython 默认不捕获C++异常，需在函数签名加except+并配C++层try/catch；未声明时异常穿透致崩溃。
为什么直接用 try/except 捕不到 C++ 异常
Cython 编译生成的 C/C++ 扩展模块中，若 C++ 代码抛出 std::exception 或其派生类（如 std::runtime_error），默认不会自动转为 Python 异常。Cython 不会拦截未声明的 C++ 异常——它们会直接穿透到 Python 解释器层，触发 SystemError: error return without exception set 或直接导致进程崩溃（SIGABRT）。
必须在 .pyx 中用 except+ 声明异常传播路径
关键动作是在 Cython 函数签名里显式标注 except +，并确保该函数调用链上所有 C++ 调用都处于 try/catch 保护中。Cython 仅对带 except + 的函数做异常转换：它会在 C++ 异常抛出后，自动调用 PyErr_SetString() 等 API 将其映射为 Python RuntimeError 或自定义异常。
-
def my_cpp_func() except +:—— 最简方式，转为RuntimeError -
def my_cpp_func() except +—— 需提前在 .pyx 中定义MyCustomError:class MyCustomError(Exception): pass，且 C++ 层需手动调用PyErr_SetString(PyExc_MyCustomError, msg) - 若函数返回值为 C 类型（如
int），仍需写except +，否则异常无法被捕获
在 .pxd 文件中声明 C++ 异常安全的 wrapper
纯 C++ 头文件（如 lib.hpp）里的函数若可能抛异常，不能直接 cdef extern from 导入。必须包一层 C 兼容的 wrapper，并在 wrapper 内做 try/catch：
// lib_wrapper.cpp
extern "C" {
int safe_call_foo(int x) {
try {
return foo(x); // 可能 throw std::invalid_argument
} catch (const std::invalid_argument& e) {
PyErr_SetString(PyExc_ValueError, e.what());
return -1;
} catch (const std::exception& e) {
PyErr_SetString(PyExc_RuntimeError, e.what());
return -1;
}
return 0;
}
}
对应在 .pxd 中声明：
Python 编程规范与最佳实践。强制 PEP 8 代码风格、语法校验、单元测试执行，适用于代码编写、审查和重构。触发词：Python、代码规范、py_compile、单元测试。
cdef extern from "lib_wrapper.h":
int safe_call_foo(int x) except -1
然后在 .pyx 中调用 safe_call_foo() 并用标准 try/except ValueError: 捕获。
容易忽略的坑：全局构造/析构和线程局部存储
C++ 异常在以下场景极难捕获，且 Cython 无任何防护机制：
- 模块初始化时（
__pyx_module_initialize）C++ 全局对象构造抛异常 → 直接导致ImportError，但无堆栈信息 - Python 线程中调用 C++ 代码，而该代码依赖 TLS（thread_local）且未在 Python 线程中正确初始化 → 可能在析构时抛异常，此时已脱离 Cython 的
except +上下文 -
except +仅对函数入口生效；若函数内启新线程并抛异常，主线程无法捕获
这类问题只能靠 C++ 层防御性编程：所有可能抛异常的全局逻辑，必须包裹在 try/catch 中并转为错误码或日志，绝不能让异常逃逸出 C++ 函数边界。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
