Ruby 解释器提供了可用于追踪 Ruby 执行的事件钩子。设置钩子用 set_trace_func(some_proc)；卸载钩子则用 set_trace_func(nil)。

追踪器恐怕是发明以来最有用的调试工具，远比基于单步和断点的调试器有用。

Ruby 追踪 8 种事件：

• line – 文件或行改变
• class – 模块或类定义开始
• end – 模块或类定义结束
• call – Ruby 方法调用
• return – Ruby 方法返回
• c-call – C 方法调用
• c-return – C 方法返回
• raise – 异常抛出

有些事件并不会被追踪，例如设置和读取变量（局部、全局、实例或者类变量）。

例子中，String#+ 运行了三次，IO#write 两次——第二次大概是输出换行符的。

Ruby 中很多东西很神奇并没有被转换为方法调用。这种东西的一种是字符串插值（... #{ code } ...），并没有被转换为 String#+ 或是 Array#join，而是直接由解释器特别的处理。

同样，创建类并没有被转化为 Class#new，添加方法并没有被转换为 Module#define_method。幸运的是 Ruby 提供了特别的钩子让我们需要捕捉这些事件——当类创建时，其父类的 inherited 方法会被调用；当一个方法被添加时，Ruby 调用其类的 method_added。

如果我们想跟踪些有用的东西，是时候改改格式了。如果我们对跟踪执行过程感兴趣，通常来说文件及行号都没什么用，return/c-return/end 则应该用缩进代替。同时，相比类，我们更注重的是接收者（`self）。

这里的输出又有点小怪癖。在 Geolocation#initialize 开始时， Geolocation#to_s 就被追踪器调用，而不是在其有意义之后。这种情况下，我们简单的得到了垃圾 <, >。但是有些对象，在初始化之前被打印是会产生异常的。

许多难以找到错误的，最终变成了琐碎的自定义追踪器、grep 或是一些一行 Ruby 脚本来美化事实。

骗局

set_trace_func 不仅仅对调试有用，也适合做各种有趣的事情。Binding.of_caller 是用 set_trace_func 实现的，虽然已经不能用了。magic/help 用了 set_trace_func 在 irb 中提供方便的帮助：

magic/help 通过设置一个 set_trace_func 钩子工作，执行传送过来的块，然后一遇到感兴趣的事件就停止执行。这意味着 help { rm_rf "/" } 完全是安全的。

我开发 magic/help 时遇到的一个难懂的问题是，方法没有按正确的参数个数调用时，追踪结果不一致。

对于 C 写的方法，就算显式声明了参数个数，Ruby 依然在 ArgumentError.new 前产生 c-call。另一方面，对于 Ruby 写的方法，ArgumentError.new 被调用，然后从函数 return 返回，而不产生 call。

要描述这个问题，我们来跟踪一下 C 方法 STDERR.write：

与此同时我们跟踪一下 Ruby 方法 FileUtils.remove_entry:

两种情况下，参数都是在调用方法之前被检查的。IO#write 是定义为一个参数的方法：

新版的 magic/help 也能处理这个情况了——如果首事件是 c-call 到 ArgumentError.new，magic/help 就等到首个 return 事件（如果有）而不是立刻放弃执行传来的块。快去下载新版，享受神奇的帮助吧。