Pythonインデントとは？初心者が間違えやすい書き方ルール

みなさん、Pythonでプログラムを書いている時に「IndentationError」というエラーに出会ったことはありませんか？

「なんでエラーになるの？」 「見た目は同じに見えるのに...」 「他の言語では動くのに、Pythonだけ違う？」

そんな疑問を抱いたことがある方も多いはず。 でも大丈夫です！

この記事では、Pythonインデントの基本ルールを初心者向けに分かりやすく解説します。 エラーの原因と対処法も含めて、一緒に理解していきましょう！

インデントって何？

インデントとは、**行の先頭に入れる空白（スペースやタブ）**のことです。 簡単に言うと、「文字を右にずらすこと」ですね。

Pythonのインデントは特別

Pythonでは、インデントがプログラムの構造を決める重要な文法の一部になっています。 これが他のプログラミング言語と大きく違う点です。

基本的な例を見てみましょう：

# インデントなし（トップレベル）
print("これは最初の行")

# インデントあり（ブロック内）
if True:
    print("これはif文の中")  # 4つのスペースでインデント
    print("同じブロック内")   # 同じレベル

print("また最初の行に戻る")  # インデントなし

実行結果：

これは最初の行 これはif文の中 同じブロック内 また最初の行に戻る

if文の中の2行が、同じだけ右にずれていることが分かりますね。

他の言語との違い

多くのプログラミング言語では、ブロックを中括弧（{}）で表現します。 でも、Pythonはインデントで表現するんです：

# Python（インデントでブロックを表現）
age = 20
if age >= 18:
    print("成人です")
    print("選挙権があります")
else:
    print("未成年です")
    print("保護者の同意が必要です")

実行結果：

成人です 選挙権があります

この方式により、Pythonのコードはとても読みやすくなります。

インデントの基本ルール

Pythonのインデントには、守らなければならないルールがあります。 これらを理解すれば、エラーを大幅に減らせますよ。

スペースとタブの使い分け

インデントには、スペースかタブのどちらかを一貫して使う必要があります：

# 推奨: スペース4つを使用
def greet(name):
    if name:
        print(f"こんにちは、{name}さん")
        return True
    else:
        print("名前が入力されていません")
        return False

実行結果：

result = greet("太郎")
# こんにちは、太郎さん

重要なポイント：

• スペース4つが最も推奨される
• タブでも問題ないが、一貫性が大切
• スペースとタブの混在は絶対にダメ

スペースとタブを混在させると、こんなエラーが出ます：

# エラーになる例（混在）
def bad_example():
    x = 1          # スペース4つ
	y = 2          # タブ1つ（見た目は同じだがエラー！）
    z = 3          # スペース4つ

# TabError: inconsistent use of tabs and spaces in indentation

エディタの設定で空白文字を可視化すると、この問題を防げます。

インデントレベルの一致

同じブロック内のコードは、同じレベルでインデントする必要があります：

# 正しいインデント
def calculate_total(items):
    total = 0
    tax_rate = 0.1
    
    for item in items:
        total += item
    
    tax = total * tax_rate
    final_total = total + tax
    
    return final_total

間違ったインデントの例：

# 間違ったインデント（エラーになる）
def bad_function():
    x = 1
      y = 2  # インデントが不揃い（IndentationError）
    z = 3

# 正しく修正
def good_function():
    x = 1
    y = 2  # 揃えて記述
    z = 3

同じブロック内では、必ず同じだけインデントしましょう。

ネストした構造のインデント

if文やループがネストした場合は、段階的にインデントを深くします：

# ネストしたif文の例
age = 25
has_license = True
has_car = False

if age >= 18:
    print("成人です")
    
    if has_license:
        print("運転免許を持っています")
        
        if has_car:
            print("車で移動できます")
        else:
            print("車をレンタルする必要があります")
    else:
        print("運転免許を取得してください")
else:
    print("未成年です")

実行結果：

成人です 運転免許を持っています 車をレンタルする必要があります

ネストが深くなるほど、インデントレベルも深くなっていきます。

よくあるインデントエラー

Pythonでプログラミングしていると、必ず出会うエラーたちです。 事前に知っておけば、慌てずに対処できますよ。

IndentationError の種類

最もよく遭遇するエラーとその対処法を見てみましょう：

エラー1: インデントがない

# エラーになるコード
if True:
print("Hello")  # IndentationError: expected an indented block

# 修正版
if True:
    print("Hello")  # 正しくインデント

エラー2: インデントが不揃い

# エラーになるコード
def my_function():
    x = 1
  y = 2  # IndentationError: unindent does not match any outer indentation level

# 修正版
def my_function():
    x = 1
    y = 2  # インデントを揃える

エラー3: 不要なインデント

# エラーになるコード
x = 1
    y = 2  # IndentationError: unexpected indent

# 修正版
x = 1
y = 2  # 同じレベルに揃える

エラー4: ブロック後のインデント忘れ

# エラーになるコード
for i in range(3):
print(i)  # IndentationError: expected an indented block

# 修正版
for i in range(3):
    print(i)  # ループ内をインデント

エラーメッセージを読むことで、どこに問題があるか分かります。

論理的なインデントミス

文法的には正しいけれど、論理的に間違ったインデントもあります：

# 間違った論理構造
score = 85

if score >= 80:
    print("合格です")
print("おめでとうございます")  # if文の外に出てしまっている

実行結果：

合格です おめでとうございます

この場合、scoreが80未満でも「おめでとうございます」が表示されてしまいます。

正しい構造：

if score >= 80:
    print("合格です")
    print("おめでとうございます")  # if文の中に含める
else:
    print("残念、不合格です")

インデントは、プログラムの論理構造を正確に表現する必要があります。

正しいインデント作成のコツ

エラーを防いで、きれいなコードを書くためのコツを紹介します。 これらを覚えれば、インデントで悩むことが減りますよ。

エディタの設定活用

効率的にインデントを管理するための設定例です：

VS Codeの推奨設定：

{
    "editor.insertSpaces": true,
    "editor.tabSize": 4,
    "editor.detectIndentation": false,
    "editor.renderWhitespace": "all",
    "python.linting.enabled": true
}

この設定により：

• Tabキーを押すとスペース4つが挿入される
• 空白文字が可視化される
• 自動でインデントエラーが検出される

適切なエディタ設定により、インデントエラーを大幅に減らせます。

一貫性の保持

プロジェクト全体でインデントスタイルを統一しましょう：

# プロジェクト全体で統一されたスタイル

# ファイル1: user.py
class User:
    def __init__(self, name):
        self.name = name
    
    def greet(self):
        if self.name:
            print(f"Hello, {self.name}")
        else:
            print("Hello, Guest")

# ファイル2: calculator.py
def add(a, b):
    result = a + b
    return result

def multiply(a, b):
    result = a * b
    return result

全ファイルでスペース4つを使用し、一貫したスタイルを保っています。

自動フォーマッターの使用

自動フォーマッターを使うと、インデントが自動で整います：

# フォーマット前（不揃いなインデント）
def messy_function():
  x=1
    y = 2
      z = 3
  if x < y:
      print("something")
    print("something else")

black や autopep8 などのフォーマッター適用後：

def messy_function():
    x = 1
    y = 2
    z = 3
    if x < y:
        print("something")
        print("something else")

コマンドライン使用例：

# blackを使用
pip install black
black filename.py

# autopep8を使用
pip install autopep8
autopep8 --in-place filename.py

自動フォーマッターにより、一貫したコードスタイルを保てます。

実践的なインデント例

実際のプログラムでよく使われる、複雑な構造でのインデント例を見てみましょう。 これらを参考に、きれいなコードを書いてください。

クラスとメソッドのインデント

オブジェクト指向プログラミングでの例です：

# 学生管理システムの例
class Student:
    def __init__(self, name, scores):
        self.name = name
        self.scores = scores
        self.average = self.calculate_average()
    
    def calculate_average(self):
        if self.scores:
            return sum(self.scores) / len(self.scores)
        else:
            return 0
    
    def get_grade(self):
        if self.average >= 90:
            return "A"
        elif self.average >= 80:
            return "B"
        elif self.average >= 70:
            return "C"
        elif self.average >= 60:
            return "D"
        else:
            return "F"
    
    def display_info(self):
        print(f"学生名: {self.name}")
        print(f"平均点: {self.average:.1f}")
        print(f"評価: {self.get_grade()}")
        
        if self.scores:
            print("個別成績:")
            for i, score in enumerate(self.scores, 1):
                print(f"  科目{i}: {score}点")

# 使用例
student = Student("田中太郎", [85, 90, 78])
student.display_info()

実行結果：

学生名: 田中太郎 平均点: 84.3 評価: B 個別成績: 科目1: 85点 科目2: 90点 科目3: 78点

クラス内でも、一貫したインデントルールを適用しています。

ネストしたループと条件分岐

複雑な処理での例です：

# 九九の表を作成する例
def create_multiplication_table():
    print("=== 九九の表 ===")
    
    for i in range(1, 10):
        print(f"
{i}の段:")
        
        for j in range(1, 10):
            result = i * j
            
            if result < 10:
                print(f"  {i} × {j} = {result:2d}")
            else:
                print(f"  {i} × {j} = {result}")
            
            if j == 5:
                print("    --- 半分通過 ---")

# 実行
create_multiplication_table()

このように、ネストが深くなっても一貫したインデントで構造を表現します。

エラーデバッグのコツ

インデントエラーが発生した時の、効果的な対処法を紹介します。 これらの方法を覚えておけば、素早く問題を解決できますよ。

エラーメッセージの読み方

エラーメッセージから問題を特定する方法です：

# エラーが発生するコード例
def debug_example():
    x = 1
    y = 2
    
    if x < y:
        print("x is smaller")
      print("this line has wrong indentation")  # エラー箇所
    
    z = 3

# エラーメッセージ:
# IndentationError: unindent does not match any outer indentation level

デバッグ手順：

1. エラーメッセージで行番号を確認
2. 該当行のインデントレベルをチェック
3. 前後の行とのインデント整合性を確認
4. エディタの空白文字表示機能を使用

修正版：

def debug_example_fixed():
    x = 1
    y = 2
    
    if x < y:
        print("x is smaller")
        print("this line now has correct indentation")  # 修正済み
    
    z = 3

エラーメッセージと行番号を手がかりに、問題箇所を特定しましょう。

エディタの支援機能

インデントエラーを防ぐためのエディタ機能を活用しましょう：

1. シンタックスハイライト

• 条件文やループがハイライトされる
• インデントブロックが色分けされる

2. インデントガイド

• 縦線でブロック構造を表示
• ネストレベルが視覚的に分かる

3. 自動インデント

• Enterキーで自動的にインデント
• ブロック終了時の自動調整

4. 空白文字の可視化

• スペースが点で表示される
• タブが矢印で表示される

これらの機能を活用することで、インデントエラーを大幅に減らせます。

まとめ

Pythonインデントの重要なポイントをまとめます。

基本ルール：

• インデントはコードブロックの構造を表現
• スペース4つまたはタブ1つを推奨
• 混在は避ける（エラーの原因）
• 同じブロック内は同じレベルでインデント

よくある間違い：

• インデントの不一致
• スペース・タブの混在
• ブロック構造の論理的ミス
• 不要なインデント

対策とコツ：

• エディタの設定を適切に行う
• 自動フォーマッターを活用する
• 空白文字の可視化機能を使用する
• 一貫したスタイルを保持する

エラー対処：

• エラーメッセージで行番号を確認
• 前後の行とのインデント比較
• エディタの支援機能を活用
• 段階的なデバッグ

インデントは、Pythonプログラミングの基礎中の基礎です。 最初は戸惑うかもしれませんが、慣れてしまえば他の言語よりも読みやすいコードが書けるようになります。

正しいインデントを意識して、美しいPythonコードを書いてみてくださいね！ きっとプログラミングがもっと楽しくなるはずです。