qiskit 无官方 c++ 接口，不可直接调用；正确做法是：纯 python 使用、换用原生 c++ 量子库（如 qpp、qsim）、或通过 ipc 与 python 进程通信。
Qiskit 是 Python 库，C++ 无法直接调用
Qiskit 根本没有官方 C++ 接口，所有 qiskit 模块（如 qiskit.quantum_info、qiskit Aer）都是纯 Python 实现，底层虽有 C/C++ 扩展（如 qiskit-aer 的 qasm_simulator），但这些扩展只暴露给 Python 解释器，不提供 C ABI 或头文件。你写 #include <qiskit></qiskit> 会直接报错 —— 这个头文件根本不存在。
常见错误现象：fatal error: qiskit/qiskit.h: No such file or directory，或链接时找不到 libqiskit —— 因为它压根没编译成独立库。
- 别试图用 pybind11 / Boost.Python “包装 Qiskit”：你包装的只是 Python 对象，不是量子电路逻辑本身；性能开销大，且无法绕过 GIL
- 别依赖“Qiskit C++ binding”这类不存在的第三方项目：GitHub 上搜到的基本是玩具 demo 或已归档废弃项目（如
qiskit-cpp仅支持极老版本且无维护） - 真实使用场景只有两种：要么用 Python 写主逻辑（推荐），要么在 C++ 中另起炉灶用其他量子模拟库
想在 C++ 里做量子模拟？换用原生 C++ 库
如果你的项目主体是 C++，又确实需要本地高性能模拟（比如嵌入式、实时反馈、HPC 耦合），应该跳过 Qiskit，直接选支持 C++ API 的模拟器：
-
qpp（Quantum++）：头文件-only，无依赖，支持状态向量和测量采样，API 类似 Qiskit 但更轻量；示例：qpp::ket psi = qpp::kets::z0; psi = qpp::apply(psi, qpp::gates::H, {0}); -
ProjectQ后端曾支持 C++，但已弃用；当前更现实的是tket（C++/Python 双接口），但它默认不带模拟器，需搭配pytket-qiskit或自接Aer—— 仍绕不开 Python - 若需高保真门级模拟，
qsim（Google）提供 C++ API 和静态库，可直接链接：qsimcirq是其 Python 封装，但源码里的libqsim可被 C++ 工程直接#include <qsim></qsim>
注意：qsim 不兼容 Qiskit 的电路格式（如 QuantumCircuit 对象），需手动转译：把 Qiskit 的 circuit.data 提取为门列表 + 量子比特索引，再喂给 qsim::Circuit<fp_type></fp_type>。
必须和 Qiskit 交互？走进程间通信（IPC）
当 C++ 主程序要动态生成电路、送进 Qiskit 模拟、再拿回结果（比如优化循环中反复调用），最稳的方式是让 Python 进程跑 AerSimulator，C++ 通过标准输入/输出或 socket 传数据。
- 避免用
system("python -c 'import qiskit; ...'")：启动开销大，无法流式交互 - 推荐方案：C++ 启动一个长期存活的 Python 子进程（如用
posix_spawn或CreateProcess），双方约定 JSON 协议 —— C++ 发送{"gates": [{"name": "h", "qubits": [0]}, {"name": "cx", "qubits": [0,1]}]}，Python 返回{"statevector": [0.707, 0, 0.707, 0]} - 性能影响：单次调用延迟约 1–10ms（不含模拟时间），比函数调用高 2–3 个数量级；但胜在完全解耦、版本兼容、调试方便
- 容易踩的坑：
qiskit-aer在子进程中首次导入可能卡住（因 OpenMP 初始化竞争），加os.environ["OMP_WAIT_POLICY"] = "PASSIVE"可缓解
Qiskit 电路导出为通用格式，在 C++ 里解析
如果只是“一次性转换”，比如把设计好的 Qiskit 电路转成 C++ 可读结构，用 Qiskit 自带的序列化功能最省事：
- 导出为 QASM 2.0：
circuit.qasm()→ 得到字符串，C++ 用std::regex或简易 parser 提取门和比特索引（注意 QASM 的qreg q[2];声明） - 导出为 OpenQASM 3（需 Qiskit > 1.0）：
qiskit.qasm3.dumps(circuit)，语法更规范，但 C++ 解析器仍得自己写 - 别用
pickle或qiskit.serialize：二进制格式无跨语言保证，Python 版本一变就失效 - 导出后，C++ 侧可用
qpp或qsim加载执行；但注意：Qiskit 默认用 little-endian 量子比特顺序，而多数 C++ 库（包括qpp）也按此约定，无需翻转
真正麻烦的从来不是“怎么传数据”，而是“谁负责管理量子态内存生命周期”——Python 的 Statevector 和 C++ 的 std::vector<:complex>></:complex> 之间没有隐式桥接，任何跨边界的拷贝都得显式做。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
