# 快速上手

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

## 构建量子线路

第一个示例将让你看到如何创建量子线路并添加量子门。建议重点关注：
- 如何使用 {class}`uniqc.circuit_builder.Circuit` 创建空线路
- 如何添加量子门（如 `h`、`cnot`）
- 如何添加测量指令 `measure`

```python
from uniqc.circuit_builder import Circuit

# 创建线路
circuit = Circuit()

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

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

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

## 本地模拟

接下来使用本地模拟器运行线路并观察结果。建议重点关注：
- 如何使用 {class}`uniqc.simulator.OriginIR_Simulator` 创建模拟器
- 如何调用 `simulate_pmeasure` 获取测量概率分布
- 输出结果的含义（概率分布）

```python
from uniqc.simulator import OriginIR_Simulator

sim = OriginIR_Simulator()

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

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

## 下一步

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

- 如果你想继续学习**如何写出更复杂的线路**，包括更多量子门、控制结构、格式导出与线路信息查看，请阅读 [构建量子线路](circuit.md)。
- 如果你已经有线路，想继续学习**如何做本地验证、采样、后端选择与限制判断**，请阅读 [本地模拟](simulation.md)。
- 如果你已经完成安装、最小示例和本地验证，准备提交到云平台或真机，请阅读 [提交任务](submit_task.md)。
- 如果你想了解 OriginIR 格式的详细说明，请阅读 [OriginIR](originir.md)。
- 如果你想了解 QASM 格式与格式互转，请阅读 [QASM](qasm.md)。
- 如果你想从命令行直接操作，请阅读 [命令行工具](../cli/index.md)。