应先用cppyy.load_library加载动态库，再用cppyy.include解析头文件；二者缺一不可，否则因符号未解析或未链接导致AttributeError或段错误。
cppyy 生成 Python 绑定时，cppyy.include 和 cppyy.load_library 到底该用哪个？
cppyy.include 是让 cppyy 解析 C++ 头文件（仅声明），不链接实现；cppyy.load_library 是加载已编译的动态库（含定义），两者必须配合使用才能调用函数。常见错误是只 include 头文件却没加载对应库，运行时报 AttributeError: 'module' object has no attribute 'xxx' 或直接段错误。
- 如果 C++ 代码已编译为
libmylib.so（Linux）或mylib.dll（Windows），先cppyy.load_library("mylib")（传名不带前缀/后缀） - 再
cppyy.include("mylib.h")，否则类型和函数名无法被识别 - 头文件路径需在
CPATH或通过cppyy.add_include_path显式添加，否则报fatal error: mylib.h: No such file - 不要试图用
cppyy.include加载 .cpp 文件——它不是预处理器，不支持实现体
用 cppyy.gbl 访问 C++ 全局命名空间时，为什么找不到类或函数？
cppyy.gbl 是 C++ 全局命名空间的 Python 映射入口，但它的内容只反映“已被 cppyy 解析过”的符号。没被 include、没被模板实例化、或被内联/优化掉的符号不会自动出现。
- 类型必须在头文件中显式声明，并被
cppyy.include成功解析（注意：前置声明不够，得有完整定义） - 模板类/函数需手动实例化，例如
cppyy.gbl.std.vector[int]才能生成绑定，std::vector本身不会自动出现 - 静态成员函数、枚举值、using 别名默认可见；但宏、typedef（非别名模板）、未导出的静态局部变量不可见
- Windows 下若 C++ DLL 导出未加
__declspec(dllexport)，即使加载成功，gbl里也看不到符号
Python 调用 C++ 对象时，生命周期管理谁负责？
cppyy 默认采用“引用传递 + 自动内存管理”策略，但边界很关键：Python 创建的对象（如 cppyy.gbl.MyClass()）由 Python GC 控制；C++ 侧 new 出来的指针（如 cppyy.gbl.new_MyClass()）则需手动 cppyy.gbl.delete_MyClass(ptr)，否则泄漏。
- 不要混用：Python 构造的实例不能传给期望“接管所有权”的 C++ 函数（如接收
std::unique_ptr的接口），会触发 double-delete - 返回裸指针的 C++ 函数（如
T* get_instance()），默认被 cppyy 视为“借用”，Python 不负责释放；需用@cppyy.cppdef包装成返回std::shared_ptr或显式标注所有权 -
std::vector、std::string等容器自动转换，但其内部数据仍归属 C++，Python 修改后 C++ 可见；反之亦然——这点和 PyBind11 不同，没有隐式拷贝开销，但也意味着别在 C++ 侧提前释放底层 buffer
为什么 cppyy.cppdef 写的内联 C++ 代码有时不生效？
cppyy.cppdef 是运行时注入 C++ 代码并即时编译，但它受当前编译上下文限制：不继承之前 include 的宏定义，不感知未加载的库符号，且重复定义会静默失败（除非开启调试模式）。
- 宏定义必须在
cppdef字符串里重写，外部头文件里的#define不可见 - 若依赖某第三方库类型（如
cv::Mat），得先确保该库已load_library且头文件已include，否则报unknown type name - 同一符号多次
cppdef不会报错，但只有第一次生效；修改后需重启 Python 进程或用cppyy.clear_cppenv()（有副作用，慎用） - Windows 上 MSVC 编译器对
cppdef支持较弱，建议统一用 clang（cppyy 默认嵌入 clang）或提前编译好再加载
实际项目里最常卡住的，是头文件里用了未导出的模板特化，或者 Windows DLL 导出列表漏了某个函数——这些错误不报链接失败，而是在 Python 侧表现为属性不存在，查起来特别绕。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
