用 Pry 调试 Ruby 应用：比 IRB 强得多的运行时控制台
Pry 是 Ruby 最强大的运行时控制台，可以替代 IRB 并在代码任意位置暂停执行、查看变量、单步调试甚至热修改代码。本文讲解 binding.pry 断点、pry-byebug 单步命令与调用栈导航。
Pry 是 IRB 的增强替代品，在代码中插入 binding.pry 即可在该处打开交互式控制台，现场查看和修改程序状态；配合 pry-byebug 插件还能获得 step/next 单步执行能力，是 Ruby 开发者排查问题的首选工具。
Pry 不只是调试器
Pry 的定位是"运行时开发控制台"：语法高亮、对象自省（ls、show-doc、show-source）、命令系统、插件生态，这些让它既能当更强的 IRB 用，也能嵌入程序当断点调试器用。相比单纯的调试器，Pry 更强调"探索"——你不知道问题在哪时，先停下来四处看看。
命令行调试脚本
不改动代码就能调试脚本：
gem install pry
pry -r ./your_script.rb
这会在 Pry 会话中加载脚本，你可以直接调用脚本里的方法、检查其返回值，逐步验证逻辑。
binding.pry：随处暂停的断点
核心用法只有一行：
def process_order(order)
binding.pry
charge(order.total)
end
执行到该行时程序挂起，进入 Pry 会话，当前作用域的一切尽在掌握：
[1] pry(#<Order>)> order.total
[2] pry(#<Order>)> order.items.map(&:price)
[3] pry(#<Order>)> ls # 列出当前作用域的方法与变量
[4] pry(#<Order>)> order.status = 'debug' # 直接改状态验证修复方案
改完代码立即重新调用方法验证，不用重启整个应用——这种"边修边试"的节奏是打印调试无法比拟的。
单步执行：pry-byebug
gem install pry-byebug
装好后 Pry 会话里多出四个命令：
step：进入方法内部逐行执行next：执行下一行，不进入方法finish：跑完当前方法停在返回处continue：放行到下一个断点
这让 Pry 具备了完整调试器的能力，同时保留它强大的自省命令。
调用栈导航：pry-stack_explorer
当 bug 埋在深层调用里时，单看断点处的状态不够，还要回溯"是谁把我调进来的"。pry-stack_explorer 插件提供：
show-stack：显示调用栈up/down：在栈帧间移动，切换后变量上下文随之改变frame 3：直接跳到指定栈帧
结合 whereami（显示当前位置源码），可以快速在复杂的调用链中定位状态异常的起源。
Rails 与测试中的 Pry
Rails 项目把 gem 'pry-rails' 放进 development 组，rails console 会自动替换为 Pry。在控制器或模型里插入 binding.pry，请求执行到该处会在服务器终端打开调试会话。RSpec 测试同样适用：在失败用例中打断点，直接检查测试现场的对象状态。
常见问题（FAQ）
Q：Pry 和 Byebug 怎么选？
不冲突，组合使用最香：pry-byebug 就是把两者拼起来的方案——Pry 负责交互界面和自省，Byebug 负责单步执行。Ruby 3.1+ 也可以考虑官方 debug gem。
Q：为什么 binding.pry 没有停住？
常见原因：代码根本没执行到（确认逻辑分支）、在 Rails 里改完代码没重启（zeitwerk 对已有进程不生效）、运行环境是非交互终端（如后台 job、CI）。后台进程调试需要用 pry-remote 之类的远程方案。
Q：如何防止调试语句被提交到仓库？
在 Git 的 pre-commit 钩子或 CI 中用 grep 检查 binding.pry、byebug、binding.irb；RuboCop 的 Lint/Debugger 规则也能自动拦截。
参考文档
本文依据公开文档整理，示例需按项目依赖版本验证；不将文档中的性能描述视为本项目实测结果。
