NameError（ネームエラー）の原因と解決法・完全攻略ガイド

フリーランスボード	20万件以上の案件から、副業に最適なリモート・週3〜の案件を一括検索できるプラットフォーム。プロフィール登録でAIスカウトが自動的にマッチング案件を提案。市場統計や単価相場、エージェントの口コミも無料で閲覧可能なため、本業を続けながら効率的に高単価の副業案件を探せます。フリーランスボード
ITプロパートナーズ	週2〜3日から働ける柔軟な案件が業界トップクラスの豊富さを誇るフリーランスエージェント。エンド直契約のため高単価で、週3日稼働でも十分な報酬を得られます。リモートや時間フレキシブルな案件も多数。スタートアップ・ベンチャー中心で、トレンド技術を使った魅力的な案件が揃っています。専属エージェントが案件紹介から契約交渉までサポート。利用企業2,000社以上の実績。ITプロパートナーズ
Midworks	10,000件以上の案件を保有し、週3日〜・フルリモートなど柔軟な働き方に対応。高単価案件が豊富で、報酬保障制度（60%）や保険料負担（50%）など正社員並みの手厚い福利厚生が特徴。通勤交通費（月3万円）、スキルアップ費用（月1万円）の支給に加え、リロクラブ・freeeが無料利用可能。非公開案件80%以上、支払いサイト20日で安心して稼働できます。Midworks

Python開発でよく遭遇する「NameError（名前エラー）」について、原因から解決法まで詳しく解説します。初心者から中級者まで役立つ実践的な内容をお届けします。

NameErrorとは

NameErrorは、定義されていない変数名、関数名、クラス名などを参照しようとした際に発生するエラーです。Pythonが「その名前を知らない」状態で起こります。

print(undefined_variable)  # 定義されていない変数を参照
# NameError: name 'undefined_variable' is not defined

NameErrorが発生する主な原因

1. 変数の定義忘れ

最も基本的なNameErrorの原因です。

# 間違い：変数を定義せずに使用
print(name)
# NameError: name 'name' is not defined

# 正解：事前に変数を定義
name = "太郎"
print(name)

2. 変数名のスペルミス

定義した変数名と異なる名前で参照した場合に発生します。

# 間違い：変数名のスペルが違う
user_name = "田中"
print(username)  # 'user_name'ではなく'username'
# NameError: name 'username' is not defined

# 正解
user_name = "田中"
print(user_name)

3. 大文字小文字の違い

Pythonは大文字小文字を区別するため、違いがあるとNameErrorになります。

# 間違い：大文字小文字が違う
myVariable = 100
print(myvariable)  # 'V'が小文字になっている
# NameError: name 'myvariable' is not defined

# 正解
myVariable = 100
print(myVariable)

4. スコープの問題

変数が定義されたスコープ外で参照しようとした場合に発生します。

# 間違い：関数内で定義した変数を外で参照
def my_function():
    local_var = "ローカル変数"

my_function()
print(local_var)  # 関数外ではアクセスできない
# NameError: name 'local_var' is not defined

# 正解：グローバル変数として定義
global_var = "グローバル変数"

def my_function():
    print(global_var)  # グローバル変数は参照可能

my_function()

5. 関数の定義忘れ

関数を定義せずに呼び出そうとした場合に発生します。

# 間違い：関数を定義せずに呼び出し
result = calculate(10, 20)
# NameError: name 'calculate' is not defined

# 正解：事前に関数を定義
def calculate(a, b):
    return a + b

result = calculate(10, 20)

6. import文の忘れ

モジュールをインポートせずに使用しようとした場合に発生します。

# 間違い：mathモジュールをインポートせずに使用
result = math.sqrt(16)
# NameError: name 'math' is not defined

# 正解：事前にインポート
import math
result = math.sqrt(16)

7. 文字列の引用符忘れ

文字列を引用符で囲まずに使用した場合に発生します。

# 間違い：文字列を引用符で囲んでいない
message = Hello World
# NameError: name 'Hello' is not defined

# 正解：引用符で囲む
message = "Hello World"

スコープによるNameError詳細解説

ローカルスコープとグローバルスコープ

# グローバル変数
global_var = "グローバル"

def function_scope():
    # ローカル変数
    local_var = "ローカル"
    print(global_var)  # グローバル変数は参照可能
    print(local_var)   # ローカル変数も参照可能

function_scope()
print(global_var)  # グローバル変数は参照可能
# print(local_var)  # エラー：ローカル変数は参照不可

global文の使用

counter = 0  # グローバル変数

def increment():
    global counter  # global文で宣言
    counter += 1

increment()
print(counter)  # 1が出力される

NameErrorのデバッグ方法

1. エラーメッセージの確認

# エラーメッセージ例
# NameError: name 'variable_name' is not defined

エラーメッセージから、どの名前が定義されていないかを確認します。

2. 変数の存在確認

# 変数が定義されているかチェック
try:
    print(variable_name)
except NameError:
    print("variable_nameが定義されていません")

3. dir()関数でスコープ内の名前を確認

# 現在のスコープで利用可能な名前を表示
print(dir())

# 特定のモジュールで利用可能な名前を表示
import math
print(dir(math))

4. locals()とglobals()で変数を確認

def debug_function():
    local_var = "ローカル"
    print("ローカル変数:", locals())
    print("グローバル変数:", globals().keys())

debug_function()

NameErrorを防ぐベストプラクティス

1. 明確な変数名の使用

# 悪い例：略語や曖昧な名前
u = "田中"
calc = 100

# 良い例：明確で分かりやすい名前
user_name = "田中"
total_amount = 100

2. 変数の初期化

# 変数を使用前に必ず初期化
count = 0
result = None
data_list = []

3. 一貫した命名規則

# snake_caseで統一（Python推奨）
user_name = "田中"
total_price = 1000
is_valid = True

4. 適切なスコープ設計

# グローバル変数は最小限に
# 関数の戻り値を活用
def calculate_total(items):
    total = sum(items)
    return total

items = [100, 200, 300]
result = calculate_total(items)

5. IDE/エディタの活用

推奨ツール:

• VS Code: 変数の定義場所表示、未定義変数の警告
• PyCharm: 高度な静的解析、リファクタリング機能
• pylint: 未定義変数の検出

実践的な対処例

ケース1: 条件分岐での変数定義漏れ

# 問題のあるコード
score = 85
if score >= 90:
    grade = "A"
elif score >= 80:
    grade = "B"
# 70点未満の場合、gradeが未定義

print(grade)  # 場合によってはNameError

# 改善版
score = 85
grade = "F"  # デフォルト値を設定

if score >= 90:
    grade = "A"
elif score >= 80:
    grade = "B"
elif score >= 70:
    grade = "C"

print(grade)

ケース2: ループでの変数スコープ

# Pythonではforループの変数は外でも参照可能
for i in range(3):
    last_value = i

print(last_value)  # 2が出力される（エラーにならない）

# ただし、ループが実行されない場合はNameError
for i in range(0):  # 実行されない
    empty_loop_var = i

# print(empty_loop_var)  # NameError

まとめ

NameErrorは変数や関数の参照に関する基本的なエラーですが、適切な対処法を知ることで効率的に解決できます。

重要なポイント:

• 変数は使用前に必ず定義する
• スペルミスや大文字小文字に注意
• スコープの概念を理解する
• エラーメッセージを注意深く読む
• 一貫した命名規則を使用する
• IDE/エディタの支援機能を活用する

NameErrorに遭遇した際は、エラーメッセージで指摘された名前が正しく定義されているか、スコープ内で参照可能かを確認することから始めましょう。経験を積むことで、これらのエラーを事前に防げるようになります。

■「らくらくPython塾」が切り開く「呪文コーディング」とは？

【革命的学習法】「らくらくPython塾」が切り開く、呪文コーディングという新時代のプログラミング習得術

■プロンプトだけでオリジナルアプリを開発・公開してみた！！

プロンプトだけでオリジナルアプリを開発・公開してみた！！

■AI時代の第一歩！「AI駆動開発コース」はじめました！

テックジム東京本校で先行開始。

AI駆動開発/生成AIエンジニアコース（初心者向け）

■テックジム東京本校

「武田塾」のプログラミング版といえば「テックジム」。
講義動画なし、教科書なし。「進捗管理とコーチング」で効率学習。
より早く、より安く、しかも対面型のプログラミングスクールです。

テックジム東京本校

＜短期講習＞5日で5万円の「Pythonミニキャンプ」開催中。

【最速・確実】プログラミング攻略「永田町Pythonミニキャンプ」【5日間で5万円】

＜月1開催＞放送作家による映像ディレクター養成講座

現役放送作家が教える動画講座！『ＤＯＧＡ』

＜オンライン無料＞ゼロから始めるPython爆速講座

【無料・オンライン】ゼロからはじめるPython爆速講座

フリーランスボード	20万件以上の案件から、副業に最適なリモート・週3〜の案件を一括検索できるプラットフォーム。プロフィール登録でAIスカウトが自動的にマッチング案件を提案。市場統計や単価相場、エージェントの口コミも無料で閲覧可能なため、本業を続けながら効率的に高単価の副業案件を探せます。フリーランスボード
ITプロパートナーズ	週2〜3日から働ける柔軟な案件が業界トップクラスの豊富さを誇るフリーランスエージェント。エンド直契約のため高単価で、週3日稼働でも十分な報酬を得られます。リモートや時間フレキシブルな案件も多数。スタートアップ・ベンチャー中心で、トレンド技術を使った魅力的な案件が揃っています。専属エージェントが案件紹介から契約交渉までサポート。利用企業2,000社以上の実績。ITプロパートナーズ
Midworks	10,000件以上の案件を保有し、週3日〜・フルリモートなど柔軟な働き方に対応。高単価案件が豊富で、報酬保障制度（60%）や保険料負担（50%）など正社員並みの手厚い福利厚生が特徴。通勤交通費（月3万円）、スキルアップ費用（月1万円）の支給に加え、リロクラブ・freeeが無料利用可能。非公開案件80%以上、支払いサイト20日で安心して稼働できます。Midworks