Ruby 變數系統中,類變數 (@@var) 與 實例變數 (@var) 是最易混淆且最具陷阱的組合。本文從定義語法、共享範圍、初始化規則、存取方式、繼承行為五個維度,系統對比兩者本質差異,並揭露「類的實例變數」這一隱藏概念。
| 特性 | 類變數 @@var | 實例變數 @var |
|---|---|---|
| 前綴符號 | @@ | @ |
| 共享範圍 | 類別及所有子類別、實例共享同一個對象 | 每個實例擁有獨立副本 |
| 初始化要求 | 使用前必須初始化,否則 NameError | 未初始化讀取返回 nil |
| 存取權限 | 私有,僅能透過類別/實例方法存取 | 私有,僅能透過實例方法存取 |
| 繼承行為 | 子類別共享同一變數,修改相互影響 | 子類別實例擁有獨立變數 |
| 類別層級變數 | 類別本身也是實例,擁有類的實例變數 | class << self 中定義的 @var 為類的實例變數 |
class Base
@@counter = 0
def increment; @@counter += 1; end
def count; @@counter; end
end
class Child < Base; end
b = Base.new
c = Child.new
b.increment # => 1
c.increment # => 2 (共享同一 @@counter)
b.count # => 2
c.count # => 2
警告: 類變數在繼承鏈中全局共享,這往往不是預期行為。Rails 內部大量使用 class_attribute 替代類變數以避免此問題。
class Demo
@class_level = "I'm class instance variable" # 類的實例變數
def initialize
@instance_level = "I'm instance variable"
end
def self.class_method
@class_level # 存取類的實例變數
end
def instance_method
@instance_level # 存取實例變數
end
end
Demo.class_method # => "I'm class instance variable"
Demo.new.instance_method # => "I'm instance variable"
# 子類別不繼承父類的「類的實例變數」
class Sub < Demo; end
Sub.class_method # => nil (未定義)
class Storage
@@class_var = 100
@class_instance_var = 200
def self.class_var_reader; @@class_var; end
def self.class_var_writer(v); @@class_var = v; end
def self.class_ivar_reader; @class_instance_var; end
def self.class_ivar_writer(v); @class_instance_var = v; end
def instance_var_reader; @instance_var ||= 300; end
def instance_var_writer(v); @instance_var = v; end
end
# 類變數:類別方法、實例方法均可存取
Storage.class_var_reader # => 100
Storage.new.instance_eval { @@class_var } # => 100
# 類的實例變數:僅類別方法可存取
Storage.class_ivar_reader # => 200
# Storage.new.instance_eval { @class_instance_var } # => nil (不同作用域)
# 實例變數:僅實例方法可存取
Storage.new.instance_var_reader # => 300
@@): 改用 class_attribute (Rails) 或「類的實例變數」+ 存取器class << self 或類別定義頂層使用 @var,配合 attr_accessor 定義類別方法initialize 或實例方法中使用 @varCONSTANT = value
class Config
@@timeout = 30
end
Config.class_variable_get(:@@timeout) # => 30
Config.class_variable_set(:@@timeout, 60)
Config.class_variables # => [:@@timeout]
徹底理解變數作用域與共享機制,是編寫健壯 Ruby 類別體系的基石。下次看到 @@ 時,請三思:你真的需要這種「全家族共享」的行為嗎?