ruby怎样调试代码

在 Ruby 中调试代码有多种方式，从最简单的打印输出，到功能强大的交互式调试器。下面按由浅入深的方式介绍常见方法：

一、最基础：puts / p / pp

1. puts

puts "当前值: #{value}"

• 自动换行
• 调用 to_s

2. p

p user

• 调用 inspect
• 更方便看对象结构

3. pp（pretty print）

require 'pp'
pp users

• 格式化输出，适合复杂结构（Hash、数组）

✅ 适合：快速定位问题

二、日志调试（Rails / 项目级）

Rails.logger.debug "user: #{user.inspect}"

或普通 Ruby：

require 'logger'
logger = Logger.new(STDOUT)
logger.debug("调试信息")

三、交互式调试器（推荐）

1. byebug（最常用，Ruby 2.x / Rails）

安装：

gem install byebug

使用：

require 'byebug'

def foo
  byebug
  puts 1 + 1
end

foo

运行后会进入调试终端：

(byebug) n     # 下一步
(byebug) s     # 进入方法
(byebug) c     # 继续执行
(byebug) p var # 查看变量

2. debug（Ruby 3+ 官方推荐）

Ruby 3 自带：

require 'debug'

def foo
  binding.break
  puts 1 + 1
end

或：

debugger

特性：

• 支持多线程
• 更好性能
• VSCode 集成

四、binding.irb（交互式 REPL）

def foo
  binding.irb
end

进入 IRB 环境，可实时执行 Ruby 代码。

✅ 适合：探索对象状态

五、异常调试

begin
  do_something
rescue => e
  puts e.message
  puts e.backtrace
end

或更简单：

raise user.inspect

六、编辑器 / IDE 调试（进阶）

VSCode

• 安装 Ruby 插件
• 使用 debug gem
• 设置断点直接调试

RubyMine

• 内置完整调试器

七、调试技巧总结

✅ 小问题：puts / p
✅ 逻辑复杂：byebug / debug
✅ 看对象结构：pp / binding.irb
✅ 生产问题：日志 + 异常捕获

如果你用的是 Rails、纯 Ruby 脚本、还是 RSpec 测试，我可以给你更具体的调试示例。