Ruby ERB中if语句为何会将变量设为nil？

问题重现 #

在ERB模板中尝试给offset参数设置默认值时，出现了诡异现象：明明offset初始值是{"z"=>-10}，但执行完判断offset.nil?的if语句后，offset突然变成nil。测试代码和输出如下：

测试代码：

<%
    # apply a default value of 0 to the offset hash
    p offset.nil?
    p offset
    p offset.nil?
    p offset

    if offset.nil?
        p "I ran the code inside the if statement"
        offset = {}
        p "offset has been initialized, since it was nil"
    end

    p offset.nil?
    p offset
%>

输出结果：

false
{"z"=>-10}
false
{"z"=>-10}
true
nil

删除if语句后，输出恢复正常：

false
{"z"=>-10}
false
{"z"=>-10}
false
{"z"=>-10}

原因分析 #

这是Ruby的局部变量提升特性导致的：

• Ruby解析代码时，只要发现某个作用域内存在变量赋值操作（比如这里的offset = {}），就会提前将该变量标记为当前作用域的局部变量，无论赋值语句是否真的执行。
• 你的测试代码中，虽然offset.nil?为false，if块根本没运行，但Ruby已经把offset当成了当前ERB代码块的局部变量。
• 由于if块没执行，这个局部变量从未被赋值，所以代码末尾输出时，它的值是nil，直接覆盖了外部传入的原始offset变量。

解决方案 #

可以通过以下几种方式避免这个问题：

1. 使用条件赋值运算符||=
   这种方式不会触发局部变量提升，直接对原始变量操作：

   <% offset ||= {} %>
   

2. 先判断变量是否已定义
   用defined?确认变量存在且非nil后，再做初始化：

   <%
   unless defined?(offset) && !offset.nil?
       offset = {}
   end
   %>
   

3. 改用实例变量
   如果offset是从控制器传入的实例变量，直接用@offset——实例变量作用域覆盖整个实例，不会被局部变量覆盖：

   <%
   @offset ||= {}
   %>
   

内容的提问来源于stack exchange，提问作者Daniel Cusumano