replacealluseswith 是最直接的更新方式：构造新指令后调用它替换所有使用，再手动 erasefromparent() 删除旧指令，否则残留 dead 指令；需注意 metadata 复制、支配关系和 ir 验证。
replaceAllUsesWith 是最直接的更新方式
LLVM IR 是 SSA 形式，每个值（Value*）有明确的定义-使用链。当你创建一条新指令（比如用 CreateSub 替代 Add），只需调用原指令的 replaceAllUsesWith(newInst)，所有引用该加法结果的地方会自动改指新减法指令。
常见错误是只改了指令本身但没更新使用者，导致后续 Pass 或后端看到“悬空”的旧定义，甚至触发断言失败（如 Use not found in use-list）。
- 必须在原指令仍有效时调用——不能在
eraseFromParent()之后再调用 -
replaceAllUsesWith不会自动删除原指令，你得手动调用Inst.eraseFromParent()（否则 IR 里残留未使用的 dead 指令） - 如果原指令有多个使用点（比如被两条
store同时用），它会全部替换，无需遍历use_begin()
为什么不能直接赋值给 Inst.getOperand(i)？
指令的操作数（operands）是只读视图，直接改 Inst.setOperand(0, newV) 只影响当前指令自身，不会通知它的所有使用者——这会破坏 SSA 不变量，IR 验证器（verifyFunction）大概率报错：Value is used but not defined 或 Instruction has inconsistent operands。
正确路径永远是：构造新值 → 替换所有使用 → 清理旧值。
-
setOperand仅适用于修改当前指令的输入依赖（例如把%a + %b改成%a + %c），不用于“替换整个定义” - 想批量重写操作数，请用
IRBuilder构造新指令，再走replaceAllUsesWith - 某些场景（如 PHI 节点）需额外处理入边，但普通二元指令不用管这个
替换后要验证 IR 是否合法
LLVM 不强制你在 Pass 中做验证，但跳过验证容易掩盖问题。尤其当替换涉及类型变化（比如把 i32 add 换成 i64 sub），下游 Pass 可能崩溃或生成错误代码。
- 开发阶段建议在
run()结尾加assert(verifyFunction(F, &errs())); - 注意
verifyFunction会检查 PHI 入边、支配关系、类型一致性等，是低成本兜底手段 - 若启用
-verify-each运行opt，每次 Pass 后都会自动校验，适合调试
替换指令时最容易漏掉的清理动作
很多新手写了 replaceAllUsesWith 就以为完事，结果 IR 体积越来越大，甚至触发 Assertion failed: !V->hasNUsesOrMore(1)。
- 必须调用
Inst.eraseFromParent()删除原指令；否则它还在基本块里，只是没人用了 - 如果原指令有 metadata（比如
!dbg），新指令默认不继承，需手动复制：newSub->copyMetadata(&Inst, /*Offset=*/0) - 若原指令在循环中且被 LICM 提升过，替换后可能影响 loop info，但 FunctionPass 级别通常不用主动更新
LoopInfo
真正麻烦的是跨基本块的使用——比如一个 Add 定义在 BB1，被 BB2 的 PHI 引用。此时 replaceAllUsesWith 依然生效，但你要确保新 Sub 所在位置对 PHI 是支配的，否则 IR 非法。最稳妥的做法是把新指令插在原指令位置（IRBuilder builder(&Inst)），这样支配关系不变。
