快速上手

本指南帮助你在完成安装后立即运行第一个量子线路示例，体验构建线路 → 本地模拟 → 查看结果的全流程。若尚未安装，请先参考 安装指南 完成环境配置。

构建量子线路

第一个示例将让你看到如何创建量子线路并添加量子门。建议重点关注：

• 如何使用 uniqc.circuit_builder.Circuit 创建空线路

• 如何添加量子门（如 h、cnot）

• 如何添加测量指令 measure

from uniqc import Circuit

# 创建线路
circuit = Circuit()

# 添加量子门
circuit.h(0)          # Hadamard 门
circuit.cnot(0, 1)    # CNOT 门
circuit.measure(0, 1) # 测量

# 查看 OriginIR 格式
print(circuit.originir)

运行上述代码后，你将看到线路的 OriginIR 文本表示，这是 UnifiedQuantum 用于描述量子线路的标准格式。

本地模拟

接下来使用本地模拟器运行线路并观察结果。建议重点关注：

• 如何使用 uniqc.simulator.Simulator 创建模拟器

• 如何调用 simulate_pmeasure 获取测量概率分布

• 输出结果的含义（概率分布）

from uniqc.simulator import Simulator

sim = Simulator()

# 概率测量
prob = sim.simulate_pmeasure(circuit.originir)
print("测量概率分布:", prob)

输出将显示各测量结果的概率值，例如 {'00': 0.5, '11': 0.5} 表示两种结果各占一半概率。

下一步

完成本示例后，请按你的当前问题进入下一页：

• 如果你想继续学习如何写出更复杂的线路，包括更多量子门、控制结构、格式导出与线路信息查看，请阅读 构建量子线路。

• 如果你已经有线路，想继续学习如何做本地验证、采样、后端选择与限制判断，请阅读 本地模拟。

• 如果你已经完成安装、最小示例和本地验证，准备提交到云平台或真机，请阅读 提交任务。

• 如果你想了解 OriginIR 格式的详细说明，请阅读 OriginIR。

• 如果你想了解 QASM 格式与格式互转，请阅读 QASM。

• 如果你想要一条覆盖”构建 → 模拟 → 提交 → 配置 → 可视化”的完整主路径走读，请阅读 主路径走读。

• 如果你想查找某个类 / 方法对应的文档页，见 主要 API 索引。

• 如果你想从命令行直接操作，请阅读 命令行工具。