Ruby 提供兩種語法定義私有方法,雖然效果相同,但在可讀性、維護性與團隊規範上有細微差異。本文對比兩種寫法,並說明 private 的作用域機制。
class C
def public_method
private_method
end
def private_method
puts "secret"
end
private :private_method # 以符號標記方法為私有
end
C.new.public_method # => "secret"
# C.new.private_method # => NoMethodError (private method called)
class C
def public_method
private_method
end
private # 開啟私有區塊
def private_method
puts "secret"
end
end
| 維度 | 事後聲明 | 區塊式聲明 |
|---|---|---|
| 可讀性 | 方法定義與可見性分離 | 視覺上明確分組 |
| 批量處理 | 需逐個列出符號 | 一次設定影響後續所有方法 |
| 插入新方法 | 易忘記加 private :sym | 自動歸入私有區塊 |
| 公開/保護切換 | 需額外行 public :sym | 插入 public/protected 關鍵字即可 |
| Ruby 風格指南 | 不推薦 | 推薦 (Ruby Style Guide) |
private 是 Module 的實例方法,非關鍵字public/protected 或類別結束self.private_method 也會失敗)super 呼叫
module Helper
private
def internal_util
"helper"
end
end
class Service
include Helper
# internal_util 在 Service 實例中也是私有的
end
class Demo
private def secret; "top"; end
def call_secret; secret; end
end
d = Demo.new
d.call_secret # => "top"
d.respond_to?(:secret) # => true (可用 respond_to? 檢查)
d.respond_to?(:secret, true) # => true (含私有方法)
# d.secret # => NoMethodError
結論: 採用「區塊式聲明」風格,配合 public/protected 明確劃分區段,符合 Ruby 社群慣例,也能減少維護時的疏漏風險。