2. 量子线路语法错误定位与修复
错误线路与解析器报错对照
下面这段线路故意埋了 4 处语法级错误，使用 Qiskit 的 QuantumCircuit 构建时会在不同阶段抛出异常。先看代码，再逐条对照报错定位。
from qiskit import QuantumCircuit, QuantumRegister, ClassicalRegister
qr = QuantumRegister(2, 'q')
cr = ClassicalRegister(2, 'c')
qc = QuantumCircuit(qr, cr)
qc.h(qr[0])
qc.cx(qr[0], qr[1])
qc.rx(0.3, 1.2, qr[0]) # 错误 A：参数个数
qc.h(qr[2]) # 错误 B：寄存器索引越界
qc.measure(qr[0], cr[0])
qc.measure(qr[1], cr[1])
qc.cx(qr[0], qr[1], qr[0]) # 错误 C：门参数个数
qc.hadamar(qr[0]) # 错误 D：门名拼写
注意：错误 A 与错误 C 属于“参数个数”类，但触发点不同——A 是旋转门多给了比特参数，C 是 CX 门多给了比特参数；错误 B 是寄存器引用越界；错误 D 是门名不存在。四类报错文本差异明显，是定位的关键线索。
逐条定位与修复
解析器报错文本是定位的第一线索，但要注意报错发生在“构建线路”阶段还是“执行/转译”阶段。本例四类错误都在构建阶段抛出，因此可以按代码顺序逐条处理。
| 编号 | 错误代码 | 报错关键文本 | 根因 | 修复写法 |
|---|---|---|---|---|
| A | qc.rx(0.3, 1.2, qr[0]) | rx() takes 2 positional arguments but 3 were given | 旋转门只接受 1 个角度参数 + 1 个比特 | qc.rx(0.3, qr[0]) |
| B | qc.h(qr[2]) | list index out of range | qr 宽度为 2，合法索引 0/1 | qc.h(qr[1]) |
| C | qc.cx(qr[0], qr[1], qr[0]) | cx() takes 2 positional arguments but 3 were given | CX 是双比特门，多传了控制比特 | qc.cx(qr[0], qr[1]) |
| D | qc.hadamar(qr[0]) | 'QuantumCircuit' object has no attribute 'hadamar' | 门名拼写错误 | qc.h(qr[0]) |
定位技巧：报错文本中的
takes N positional arguments 直接告诉你该门期望几个实参；list index out of range 说明寄存器索引超出声明宽度；has no attribute 说明方法名不存在，优先怀疑拼写。三类文本对应三类根因，不必逐行猜测。修复后验证
修复完成后，用三个检查点确认线路可被正确解析：
- 构建无异常：重新执行构建代码，不再抛出
TypeError、IndexError或AttributeError。 - 门数量核对：修复后线路应包含 H、CX、RX、H、M、M、CX、H 共 8 个操作，
qc.size()返回 8。 - 转译可解析：调用
transpile(qc, basis_gates=['u','cx'], optimization_level=0)不报错，说明线路结构对后端合法。
from qiskit import transpile
assert qc.size() == 8
tqc = transpile(qc, basis_gates=['u', 'cx'], optimization_level=0)
print(tqc.count_ops()) # 预期包含 u、cx、measure
修复顺序建议：先修“门名/属性不存在”（D），再修“参数个数”（A、C），最后修“索引越界”（B）。原因是属性错误会让后续行无法执行，而参数个数错误与索引错误互不影响，可独立修复。每修一处立即重跑构建，避免多个错误叠加导致报错文本被覆盖。