量子程序编译器QLLVM入门基于LLVM的经典-量子混合编译器QLLVM 入门指南基于 LLVM 的经典-量子混合编译器一、QLLVM 是什么它能做什么解决什么问题核心优势二、安装方式方式一VSCode 插件推荐方式二从源码安装三、基本用法3.1 编译纯量子程序3.2 编译 C 和量子混合程序3.3 编译 C CUDA 量子混合程序四、常见问题五、更多资源QLLVM 入门指南基于 LLVM 的经典-量子混合编译器一、QLLVM 是什么QLLVM是一个基于 LLVM 构建的经典-量子混合编译框架具备卓越的可扩展性以及与经典高性能计算生态的无缝集成能力。它能做什么把量子程序Qiskit/Cirq/openQASM 等和 C/CUDA 程序放在一起编译生成一个可执行文件解决什么问题量子编程框架存在的生态碎片化问题前端接口不统一、后端硬件强耦合、编译能力重复构建且与 HPC 生态脱节现有“量-超-智”融合方案存在的局限性问题CUDA Quantum 对传统 HPC 场景支持不足Qiskit Runtime 通信延迟大、无法实现编译层全局优化现有 LLVM/MLIR 路径在物理比特映射等关键环节支持不成熟问题多数量子编译器以“量子为中心”未将 CUDA、OpenMP/MPI 等纳入统一编译视图核心优势✅ 统一编译量子经典代码一次性编译无需胶水代码✅ 多前端支持Qiskit、Cirq、Qpanda、openQASM✅ 多后端输出openQASM 2.0、OriginIR、qcis✅ 支持 C/CUDA 与量子程序混合编译✅ 无量子硬件也能跑内置模拟器✅ 开放性与互操作性基于 LLVM 开放标准硬件无关、平台中立避免厂商生态锁定✅ 全栈性能优化内置 SABRE 物理比特映射算法✅ 模块化设计框架采用模块化架构便于后续功能扩展项目地址https://github.com/QCFlow/QLLVM二、安装方式方式一VSCode 插件推荐如果不想折腾编译环境可以直接用 VSCode 插件。安装步骤打开 VSCode进入扩展面板CtrlShiftX搜索qcflow-publisher.qcoder-chat点击安装安装后会自动带上编译插件不需要额外配置。使用左侧侧边栏打开 Qcoder在代码区域写量子程序点击编译按钮点击运行按钮输出结果在下方显示方式二从源码安装如果需要命令行使用可以从源码编译。详细安装要求参考官方文档https://qllvm-documentation.readthedocs.io三、基本用法3.1 编译纯量子程序qllvm test_bell.qasm-qrtnisq-qpuqasm-backend-O1这条命令会编译test_bell.qasm输出优化后的量子电路文件test_bell_compiled.qasm。参数说明-qrt nisq运行时模式目前用 nisq-qpu qasm-backend后端选择qasm-backend 是模拟器-O1优化级别可选 O0/O1/O2/O33.2 编译 C 和量子混合程序qllvm main.cpp bell.qasm-ohybrid_bell ./hybrid_bell前提是main.cpp里调用了量子电路接口。具体接口写法可以参考仓库examples/hybrid/目录下的示例。3.3 编译 C CUDA 量子混合程序cdexamples/hybrid_cuda qllvm main.cpp kernel.cu circuit.qasm-ohybrid_app -cuda-arch sm_86 ./hybrid_app-shots1024这里-cuda-arch sm_86指定 CUDA 架构根据本地 GPU 修改需要本地已安装CUDA工具链以上示例均来自官方仓库https://github.com/QCFlow/QLLVM/tree/master/examples更详细的使用示例请参考官方文档https://qllvm-documentation.readthedocs.io源码仓库示例https://github.com/QCFlow/QLLVM/tree/master/examples四、常见问题Q1没有量子硬件能不能用可以。qasm-backend是模拟器在经典计算机上运行量子电路。Q2支持哪些量子编程框架前端支持Qiskit、Cirq、Qpanda、openQASM。也就是说你可以用这些框架写量子程序然后通过 QLLVM 编译成目标指令。Q3插件和命令行有什么区别插件适合快速体验、教学、不关心底层配置命令行适合集成到现有构建流程、脚本自动化Q4编译报错怎么办先确认依赖是否完整LLVM、CUDA如果需要查看官方文档的安装部分在 GitHub 提交 Issue五、更多资源官方文档https://qllvm-documentation.readthedocs.ioGitHub 仓库https://github.com/QCFlow/QLLVMGitee 仓库https://gitee.com/QCFlow/QLLVMIssues 反馈https://github.com/QCFlow/QLLVM/issues以上是 QLLVM 的基本使用方法。如果有具体的使用问题建议先看官方文档或者直接提交 Issue。