未定义的变量记录器导轨 - Ruby

在 Ruby 中，当我们使用未定义的变量时，Ruby 引擎会抛出一个 NameError 异常。如果程序中出现大量的未定义变量，那么调试和定位错误将会变得困难。

为了更好地解决这个问题，我们可以使用 Ruby 的一个特性 - 记录器导轨。在记录器导轨中，所有的未定义变量都会被记录下来。这样一来，我们就可以通过查看记录来查找是哪个变量未定义了，从而更快地定位和修复错误。

使用方法

在需要记录未定义变量的 Ruby 程序中，只需要在程序开头加入以下代码：

require 'English'
$VERBOSE = true

这样设置之后，Ruby 引擎就会记录所有未定义变量的信息到 $ERROR_INFO 全局变量中。我们可以在程序出现未定义变量时，直接在终端中使用 puts 方法输出此变量：

rescue NameError => e
  puts "Caught error: #{e.message}"
  puts "Undefined variable: #{e.name}" if e.name =~ /^[[:lower:]]\w+$/
  puts "Backtrace:\n\t#{e.backtrace.join("\n\t")}"

值得注意的是，$ERROR_INFO 只记录最近出现的一个未定义变量。如果你需要记录多个未定义变量，需要在每次记录后手动清空 $ERROR_INFO 变量，以便重新记录下一个未定义变量。

实例

以下代码演示了如何在 Ruby 中使用记录器导轨：

require 'English'
$VERBOSE = true

def catch_error
  x = 1
  y = z
rescue NameError => e
  puts "Caught error: #{e.message}"
  puts "Undefined variable: #{e.name}" if e.name =~ /^[[:lower:]]\w+$/
  puts "Backtrace:\n\t#{e.backtrace.join("\n\t")}"
  $ERROR_INFO = nil
end

catch_error()

输出结果：

Caught error: undefined local variable or method `z' for main:Object
Undefined variable: z
Backtrace:
    ruby 2.7.0p0 (2019-12-25 revision 647ee6f091) [x86_64-darwin18]
    test.rb:6:in `catch_error'
    test.rb:12:in `<main>'

参考资料

• Ruby 全局变量
• The $ERROR_INFO Variable