Python调用C++ DLL必须用extern "C"关闭名称修饰并显式导出符号，否则ctypes因找不到修饰后函数名而报错；需配合__declspec(dllexport)（Windows）或__attribute__((visibility("default")))（Linux/macOS），且参数返回值须为C兼容类型。
确认C++库是否导出符号且符合Python调用约定
Python通过ctypes或cffi调用C++动态库时，实际只能调用C风格函数——C++的名称修饰（name mangling）会让函数名在编译后变成不可预测的符号，直接cdll.LoadLibrary会报AttributeError: function 'xxx' not found。
必须在C++源码中用extern "C"显式关闭修饰，并确保函数参数/返回值是C兼容类型（如int、double、const char*，避免std::string或引用）：
extern "C" {
__declspec(dllexport) int add(int a, int b); // Windows下需__declspec(dllexport)
__attribute__((visibility("default"))) double multiply(double x, double y); // Linux/macOS用__attribute__
}编译时也要注意导出控制：Windows用/LD（MSVC）或-shared -fPIC（GCC/Clang），Linux/macOS默认不导出所有符号，必须加-fvisibility=default或显式标记。
用ctypes加载时路径和依赖问题怎么解
ctypes.CDLL或ctypes.cdll.LoadLibrary失败，常见原因不是库文件不存在，而是运行时找不到它或它的依赖项。尤其C++库常依赖libstdc++.so（Linux）、libc++.dylib（macOS）或msvcp140.dll（Windows）。
立即学习“Python免费学习笔记（深入）”；
- Windows：把DLL和它的依赖（可用
Dependencies.exe查）放在Python脚本同目录，或添加到PATH环境变量 - Linux：用
ldd your_lib.so检查缺失的.so，把路径加进LD_LIBRARY_PATH，或用patchelf --set-rpath硬编码搜索路径 - macOS：检查
otool -L your_lib.dylib，用install_name_tool -change修正依赖路径，避免Library not loaded
临时验证可先在Python里手动补全路径：os.add_dll_directory(r"C:\path\to\deps")（Windows 3.8+），Linux/macOS则必须靠系统级路径配置。
Python中如何安全传参并处理C++内存
C++函数若返回堆上分配的内存（如new char[100]），Python无法自动释放，极易内存泄漏；若接收Python传入的bytes或str，需注意编码和缓冲区边界。
- 输入字符串：用
my_lib.func.argtypes = [c_char_p]，传b"hello"（bytes）；若需UTF-8 str，先s.encode('utf-8') - 输出字符串：C++函数应返回
const char*且内存由C++长期持有（如静态缓冲区），或改用输出参数char* buf, size_t len让Python分配缓冲区 - 数组传递：用
(c_int * 5)(1,2,3,4,5)构造C数组，.contents或[i]访问；避免直接传Pythonlist
关键原则：谁分配，谁释放。Python不碰C++ new/malloc的内存，除非C++同时提供free_result()接口并由Python显式调用。
跨平台编译和ABI兼容性避坑点
同一个C++源码，在不同平台/编译器/标准库下生成的动态库不能混用。最隐蔽的问题是C++标准库ABI不兼容：GCC 5+默认用libstdc++新ABI（_GLIBCXX_USE_CXX11_ABI=1），而旧Python扩展可能链接老ABI，导致undefined symbol。
- Linux：编译时加
-D_GLIBCXX_USE_CXX11_ABI=0强制兼容旧ABI（尤其对接conda或系统Python） - macOS：Clang默认用
libc++，但某些Python发行版（如pyenv编译的）可能用libstdc++，需统一 - Windows：MSVC版本必须匹配Python构建版本（如CPython 3.9官方版用VS 2019，就不能用VS 2022编译的DLL）
真正可靠的分发方式不是扔一个.so/.dll，而是用setuptools + pybind11打包成.pyd（Windows）或.so（类Unix），让构建过程自动对齐Python ABI。
