Rubyのクラス変数（@@）の仕組みと注意点：クラスインスタンス変数との使い分けを解説

Rubyプログラミングにおいて、変数のスコープを正しく理解することは、バグの少ない堅牢なコードを記述するための第一歩です。

中でも「クラス変数」は、その挙動が独特であり、意図しないデータの書き換えを引き起こすリスクを孕んでいます。

本記事では、Rubyのクラス変数である「@@」の仕組みから、継承関係における共有のルール、そしてより安全な代替案である「クラスインスタンス変数」との違いについて詳しく解説します。

開発現場で混乱を招きがちなこれらの仕様を整理し、2026年現在のモダンなRuby開発において推奨される設計手法を学んでいきましょう。

Rubyのクラス変数の基本構造

Rubyにおけるクラス変数とは、変数名の先頭に @@ を付与することで定義される変数を指します。

この変数の最大の特徴は、クラスのすべてのインスタンス間で同じ値を共有できる点にあります。

通常のインスタンス変数（@）が各オブジェクトごとに独立した値を保持するのに対し、クラス変数はクラスそのものに紐付くデータを保持するために使用されます。

例えば、そのクラスからこれまでに何個のオブジェクトが生成されたかをカウントする用途などに適しています。

具体的な定義方法とアクセス方法を以下のコードで確認してみましょう。

class User
  @@user_count = 0 # クラス変数の初期化

  def initialize(name)
    @name = name
    @@user_count += 1 # インスタンスが生成されるたびに加算
  end

  def self.total_count
    @@user_count # クラスメソッドからクラス変数にアクセス
  end
end

user1 = User.new("Alice")
user2 = User.new("Bob")

puts User.total_count

2

上記の例では、User.new が呼び出されるたびにクラス変数 @@user_count がインクリメントされています。

このように、クラス全体で状態を共有したい場合にクラス変数は非常に便利な仕組みとして機能します。

継承関係におけるクラス変数の共有挙動

クラス変数を利用する上で最も注意しなければならないのが、継承関係にあるクラス間でも変数が共有されるという性質です。

これは、スーパークラス（親クラス）で定義されたクラス変数が、そのサブクラス（子クラス）からも参照・更新が可能であることを意味します。

一見すると便利な機能に思えますが、この仕様が原因で予期せぬサイドエフェクトが発生することが多々あります。

まずは、継承によってどのように値が共有されるのかを以下のコードで見てみましょう。

class ApplicationSetting
  @@theme = "light"

  def self.theme
    @@theme
  end

  def self.set_theme(val)
    @@theme = val
  end
end

class AdminSetting < ApplicationSetting
end

# 親クラスの値を参照
puts "Parent: #{ApplicationSetting.theme}"
puts "Child: #{AdminSetting.theme}"

# 子クラスで値を変更
AdminSetting.set_theme("dark")

puts "--- After change in Subclass ---"
puts "Parent: #{ApplicationSetting.theme}"
puts "Child: #{AdminSetting.theme}"

Parent: light
Child: light
--- After change in Subclass ---
Parent: dark
Child: dark

実行結果からわかる通り、子クラスである AdminSetting で値を変更したにもかかわらず、親クラスである ApplicationSetting の値まで書き換わっています。

これがクラス変数の持つ「強力な共有性」の正体です。

サブクラスでの書き換えが親クラスに及ぼす影響

なぜこのような挙動になるのかというと、Rubyのクラス変数は「クラスの継承ツリー全体で一つの実体を共有する」ように設計されているからです。

インタプリタはクラス変数を探索する際、現在のクラスになければ親クラスへと遡って変数を探しに行きます。

もし親クラスで既に定義されていれば、その変数をそのまま利用するため、別々のクラスであっても同じメモリ領域を指すことになります。

この挙動を理解せずにクラス変数を使用すると、ライブラリやフレームワークの基底クラスの値を、意図せずアプリ全体で書き換えてしまうといった重大なトラブルに繋がりかねません。

そのため、Rubyのコーディング規約やスタイルガイドの多くでは、クラス変数の使用を控えるよう推奨されています。

クラス変数が抱える主な問題点と注意点

クラス変数の使用には、前述した継承の問題以外にもいくつかのリスクが存在します。

まず第一に、カプセル化の破壊が挙げられます。

本来、クラスは自身の内部状態を適切に管理すべきですが、クラス変数は継承ツリー内のどこからでも自由に変更できてしまいます。

次に、変数の検索順序による混乱があります。

Rubyは実行時にクラス変数を探索するため、定義場所によっては期待しない値が取得されることがあります。

また、クラス変数は一度定義されると、その名前の変数がツリーのどこかにある限り、すべてのサブクラスがそれに縛られることになります。

以下に、クラス変数の主なリスクをまとめました。

• グローバル変数に近い挙動： 継承ツリー全体に影響が及ぶため、影響範囲の特定が困難になります。
• デバッグの難化： どこで値が変更されたかを追跡するのが難しく、大規模なプロジェクトではバグの温床となります。
• スレッドセーフティの懸念： 共有リソースであるため、マルチスレッド環境でのアクセス制御に注意が必要です。

これらの理由から、多くのプロフェッショナルなRubyエンジニアは、クラス変数の代わりに後述する「クラスインスタンス変数」を好んで使用します。

クラスインスタンス変数の導入とメリット

クラス変数の問題を解決するための有力な代替手段が、「クラスインスタンス変数」です。

Rubyにおいて、クラス自体も Class クラスのインスタンス（オブジェクト）であることを思い出してください。

したがって、クラス定義のコンテキスト内で定義されたインスタンス変数（@）は、そのクラスオブジェクト自身の持ち物となります。

これがクラスインスタンス変数と呼ばれるもので、@@ ではなく @ を使用して定義します。

最大のメリットは、継承されても値が共有されないという点にあります。

実際にコードで比較してみましょう。

class BaseClass
  @config = "default" # クラスインスタンス変数の定義

  def self.config
    @config
  end

  def self.set_config(val)
    @config = val
  end
end

class SubClass < BaseClass
end

puts "Base: #{BaseClass.config}" # => default
puts "Sub: #{SubClass.config}"   # => (nil)

SubClass.set_config("custom")

puts "--- After changing SubClass ---"
puts "Base: #{BaseClass.config}" # => default
puts "Sub: #{SubClass.config}"   # => custom

Base: default
Sub: 
--- After changing SubClass ---
Base: default
Sub: custom

この結果からわかるように、SubClass で値を変更しても BaseClass の値には全く影響を与えていません。

また、初期状態では SubClass の @config は nil であり、親の設定を自動で引き継ぐこともありません。

スコープの分離による安全性

クラスインスタンス変数を使用すると、各クラスが独立した状態を持つことができるため、設計が非常にクリーンになります。

「親クラスで定義したデフォルト値を子クラスで上書きしたいが、親クラスの設定は変えたくない」という要件は、システム開発において頻出します。

クラスインスタンス変数は、まさにこのような独立した設定管理に適しています。

ただし、一つ注意点として、インスタンスメソッドからは直接参照できないという制約があります。

インスタンスメソッドからクラスインスタンス変数にアクセスしたい場合は、self.class.variable_name のようなアクセサメソッドを経由する必要があります。

徹底比較：クラス変数 vs クラスインスタンス変数

それぞれの変数の特性を整理するために、主要な違いを表にまとめました。

基本的には、「本当にすべての継承先で同じ値を共有し、同期させる必要があるか？」を自問自答してください。

もし答えが「No」であれば、迷わずクラスインスタンス変数を選択しましょう。

モダンなRuby開発におけるベストプラクティス

2026年現在のRuby開発では、クラス変数の直接使用を避けつつ、より高度な機能を利用することが一般的です。

例えば、Ruby on Railsなどのフレームワークを使用している場合、class_attribute という機能が提供されています。

これは、クラス変数の「共有のしやすさ」と、クラスインスタンス変数の「安全な上書き」の両方の利点を備えた非常に強力な仕組みです。

また、単に「変更されない共通の定義」を扱いたいのであれば、定数（Constant）を使用するのが最も適切です。

状況に応じた最適な選択肢を検討するためのフローを以下に示します。

1. 値が不変の場合： 定数 (UPPER_CASE) を使用する。
2. クラスごとに個別の設定を持ちたい場合： クラスインスタンス変数 (@) を使用する。
3. 親から値を継承しつつ、子で上書きしても親に影響させたくない場合： class_attribute や、親の値をコピーするアクセサを実装する。
4. どうしても全継承ツリーで一つの実体を共有しなければならない場合のみ： クラス変数 (@@) を検討する（ただし非常に稀）。

このように、クラス変数は「最終手段」として捉えておくのが安全です。

また、クラスインスタンス変数を利用する際には、以下のように class << self を使ってアクセサを定義すると、外部からの利用がスムーズになります。

class DatabaseConnector
  @timeout = 30

  class << self
    attr_accessor :timeout
  end
end

DatabaseConnector.timeout = 60
puts DatabaseConnector.timeout

60

この記述により、DatabaseConnector.timeout という形でクラスの外部から安全に設定値を操作できるようになります。

まとめ

Rubyのクラス変数 @@ は、クラスおよびそのサブクラス全体でデータを共有するための強力な仕組みです。

しかし、その強力すぎる共有性は、特に継承関係が複雑になるほど予期せぬ不具合の原因となります。

本記事で解説した通り、クラス変数の挙動とリスクを正確に理解した上で、より安全な「クラスインスタンス変数」を優先的に使用することが、現代のRubyプログラミングにおける鉄則です。

変数のスコープを適切に設計することは、コードの可読性を高めるだけでなく、保守性の向上にも直結します。

今回学んだ知識を活かして、副作用の少ない、洗練されたRubyコードの記述を目指してください。