Ruby ERROR

Ruby NameError: undefined local variable の解決法

Q: 変数とメソッドどちらのエラー？

Rubyでは引数なしのローカル変数参照とメソッド呼び出しが同じ書き方のため、両方の可能性を示すこのメッセージになります。まず綴りと、その名前を先に定義しているかを確認します。

Q: NameError と NoMethodError の違いは？

NoMethodError は NameError のサブクラスです。レシーバ（obj.method の obj）があり、その型にメソッドが無いときは NoMethodError。レシーバを書かずに名前だけ参照して、変数にもメソッドにも該当が無いときは NameError です。エラー文に undefined method ... for なら NoMethodError、undefined local variable or method なら NameError です。

Q: uninitialized constant が出ます

定数（大文字始まり・クラス名・モジュール名）が見つかりません。主因は3つ。1) その定義ファイルを require し忘れている、2) 名前空間が違う（Foo::Bar を Bar と書いている）、3) 綴り・大文字小文字の違いです。gem なら require 'gem名' も確認します。

Q: メソッドの中で外の変数が NameError になります

def ... end で作るメソッドは外のローカル変数を見られません（スコープが切れる）。引数で渡すか、定数・インスタンス変数にします。ブロック（do...end や {}）は外の変数を見られる点が def と違います。

Q: did you mean? と一緒に出る名前は？

did_you_mean gem が候補を提案しています。多くはその候補が正解（打ち間違い）です。候補が出ないときは定義自体が無い、または読み込み前に呼んでいます。

Q: 文字列のつもりが NameError になります

クォートを付け忘れています。puts hello は hello という変数/メソッドの参照、puts "hello" が文字列です。

Q: 定義したのに undefined と言われます

定義より前の行で使っています。Rubyは上から実行するため、変数は代入行より後、メソッド・クラスは def/class を通過した後でないと参照できません。呼び出しを下へ移動します。

Q: NameError を rescue で捕まえられますか？

rescue NameError で捕捉できます（NoMethodError も一緒に入ります）。ただし多くは打ち間違い＝バグなので、握りつぶさずに直すのが基本です。動的な名前解決をする場合のみ defined? で存在確認してから使います。

未定義の変数・メソッド・定数を参照したときのエラーです。スペルミス、定義順、require漏れ、スコープ切れが主な原因。uninitialized constantやNoMethodErrorとの違いも下で整理します。

このエラーメッセージ

NameError: undefined local variable or method `mesage'

原因

変数名・メソッド名のスペルミス
変数を定義する前に使っている
文字列のクォート付け忘れ

❌ エラーになるコード

message = "Hello"
puts mesage

✅ 修正したコード

message = "Hello"
puts message

▶ 修正済みコードを実行エディタで開く

progoのRuby実行環境（インストール不要・登録不要）でその場で動作を確認できます。

解決のポイント

エラーに出た名前と定義した名前が一致しているか確認します。Rubyは大文字小文字を区別します。文字列を書くつもりならクォート""で囲みます（囲まないとメソッド名と解釈されます）。

メッセージ別・原因早見表

メッセージ	主な原因	確認すること
undefined local variable or method `x'	綴り違い／定義前に参照／クォート忘れ	名前の一致・代入行の位置・`""`の有無
`uninitialized constant Foo`	`require`漏れ／名前空間違い／綴り	定義ファイルの読み込み・`Bar::Foo`か・大文字小文字
`uninitialized constant Foo::Bar`	`Foo`の中に`Bar`が無い	正しい階層・別モジュール所属でないか
undefined method `x' for ...	これはNoMethodError（別ページ）	レシーバの型・`nil`でないか
`... Did you mean? y`	打ち間違い（候補`y`が正解のことが多い）	提案どおりに直す

NameError と NoMethodError の違い

NoMethodErrorはNameErrorのサブクラスです。切り分けはエラー文の形で判断します。

	NameError	NoMethodError
書き方	名前だけ参照 `foo`	レシーバ付き `obj.foo`
エラー文	`undefined local variable or method`	undefined method `foo' for ...
典型原因	綴り違い・定義前参照・定数未読込	レシーバが`nil`・型違い・メソッド名違い

uninitialized constant の3大原因

user = User.new("Sato")
# → uninitialized constant User

1. require 忘れ — 別ファイルのclass Userを読み込んでいない。require_relative "user"（gem なら require "gem名"）を先頭に。
2. 名前空間違い — Admin::User なのに User と書いている。フルパスで書くか include Admin。
3. 綴り・大文字小文字 — APIClient と ApiClient、HTTP と Http の混同。定義側の表記に合わせる。

❌ メソッドの中から外の変数を見るケース

count = 10
def show
  puts count      # def はスコープが切れる
end
show
# → undefined local variable or method `count'

count = 10
def show(count)
  puts count
end
show(count)

▶ この例を実行エディタで開く

progoのRuby実行環境（インストール不要・登録不要）でその場で動作を確認できます。

ブロック（each do |x| ... end や { }）は外のローカル変数を参照できます。スコープが切れるのはdef・class・moduleです。

did you mean? の読み方

Ruby 2.3以降はdid_you_meanが候補を出します。ほとんどの場合その候補が正解です。

test.rb:2:in `<main>': undefined local variable or method `lenght' (NameError)
Did you mean?  length

候補が出ないときは、その名前がまだ定義されていないか、定義行より前で呼んでいる可能性が高いです。ruby -cやdefined?(名前)で存在を確認できます。

よくある質問

変数とメソッドどちらのエラー？

Rubyでは引数なしのローカル変数参照とメソッド呼び出しが同じ書き方のため、両方の可能性を示すメッセージになります。まず綴りと定義順を確認します。

NameError と NoMethodError の違いは？

NoMethodError は NameError のサブクラスです。obj.method の形で型にメソッドが無ければ NoMethodError、名前だけ参照して該当が無ければ NameError です。

uninitialized constant が出ます

定数・クラス名が見つかりません。require 忘れ／名前空間違い／綴り違いの3つを確認します。

メソッドの中で外の変数が NameError になります

def で作るメソッドは外のローカル変数を見られません。引数で渡すか定数・インスタンス変数にします。ブロックは外の変数を見られます。

did you mean? と一緒に出る名前は？

did_you_mean が候補を提案しています。多くはその候補が正解（打ち間違い）です。

文字列のつもりが NameError になります

クォートを付け忘れています。puts hello は変数/メソッド参照、puts "hello" が文字列です。

定義したのに undefined と言われます

定義より前の行で使っています。呼び出しを def/class より後ろへ移動します。

NameError を rescue で捕まえられますか？

rescue NameError で捕捉できます（NoMethodError も含む）。ただし多くはバグなので握りつぶさず直すのが基本です。