初心者向け No.45

ハングマンゲーム

単語を1文字ずつ推測するハングマンゲーム。ASCIIアートの段階表示と文字列処理の組み合わせを学びます。

🎯 難易度: ★★☆ 📦 ライブラリ: tkinter（標準ライブラリ） ⏱️ 制作時間: 30〜90分

📋 目次

1. アプリ概要
2. 機能一覧
3. 事前準備・環境
4. 完全なソースコード
5. コード解説
6. ステップバイステップガイド
7. カスタマイズアイデア
8. よくある問題と解決法
9. 練習問題

1. アプリ概要

単語を1文字ずつ推測するハングマンゲーム。ASCIIアートの段階表示と文字列処理の組み合わせを学びます。

このアプリはゲームカテゴリに分類される実践的なGUIアプリです。使用ライブラリは tkinter（標準ライブラリ） で、難易度は ★★☆ です。

このアプリは「ゲーム」カテゴリです。ゲーム実装は GUI イベント処理・状態管理・描画ループを同時に学べる教材で、画面・入力・ロジックの三層分離の感覚が掴めます。tkinter（標準ライブラリ） を活かして実装するこの構造は、他のアプリにも応用が効きます。

コードを読む前に実行することをおすすめします。動いている挙動を先に把握しておくと、解説で出てくる関数や処理がどこに対応するかが頭に入りやすくなります。

応用のヒントは、機能を 1 つ増やす・見た目を整える・例外を一つでも丁寧に扱う、のいずれかから始めるのがおすすめです。

ハングマンゲーム実行画面（Linux Mint） — 実行画面（Linux Mint）

2. 機能一覧

ループで生成するボタン群を guess() に接続
「新しいゲーム」ボタン（new_game()）で操作
ウィンドウはタイトル「ハングマンゲーム」・サイズ 540x480 で起動

3. 事前準備・環境

ℹ️

動作確認環境

Python 3.10 以上 / Windows 11（実機）で起動・基本操作を確認／ Linux Mint 22.3（仮想マシン）で起動・画面表示を確認（macOS は未検証）

Windows 11（実機）で起動と基本操作を確認しています（全機能の網羅テストではありません）。Linux Mint 22.3（仮想マシン）では起動と画面表示を確認しました。macOS は標準ライブラリの範囲で動作する想定ですが、未検証です。

Python 3.10 以上
OS: Windows 11（実機で起動・基本操作を確認）・Linux Mint 22.3（仮想マシンで起動・画面表示を確認）

4. 完全なソースコード

💡

コードのコピー方法

右上の「コピー」ボタンをクリックするとコードをクリップボードにコピーできます。

✅ 追加インストール不要（標準ライブラリのみ使用）

app45.py

import tkinter as tk
from tkinter import ttk, messagebox
import random


class App45:
    """ハングマンゲーム"""

    WORDS = [
        ("python", "プログラミング言語"),
        ("function", "関数"),
        ("variable", "変数"),
        ("integer", "整数"),
        ("library", "ライブラリ"),
        ("iterator", "イテレータ"),
        ("exception", "例外"),
        ("dictionary", "辞書"),
        ("boolean", "真偽値"),
        ("algorithm", "アルゴリズム"),
        ("tkinter", "GUIライブラリ"),
        ("debugger", "デバッガ"),
        ("compiler", "コンパイラ"),
        ("module", "モジュール"),
        ("syntax", "構文"),
    ]

    HANGMAN = [
        "",
        "  |\n  |\n  |\n  |\n====",
        "  +---+\n  |   |\n      |\n      |\n      |\n      |\n====",
        "  +---+\n  |   |\n  O   |\n      |\n      |\n      |\n====",
        "  +---+\n  |   |\n  O   |\n  |   |\n      |\n      |\n====",
        "  +---+\n  |   |\n  O   |\n /|   |\n      |\n      |\n====",
        "  +---+\n  |   |\n  O   |\n /|\\  |\n      |\n      |\n====",
        "  +---+\n  |   |\n  O   |\n /|\\  |\n /    |\n      |\n====",
        "  +---+\n  |   |\n  O   |\n /|\\  |\n / \\  |\n      |\n====",
    ]
    MAX_WRONG = len(HANGMAN) - 1

    def __init__(self, root):
        self.root = root
        self.root.title("ハングマンゲーム")
        self.root.geometry("540x480")
        self.root.configure(bg="#f8f9fc")
        self._build_ui()
        self.new_game()

    def _build_ui(self):
        title_frame = tk.Frame(self.root, bg="#3776ab", pady=12)
        title_frame.pack(fill=tk.X)
        tk.Label(title_frame, text="ハングマンゲーム",
                 font=("Noto Sans JP", 16, "bold"),
                 bg="#3776ab", fg="white").pack()

        main_frame = tk.Frame(self.root, bg="#f8f9fc", padx=20, pady=12)
        main_frame.pack(fill=tk.BOTH, expand=True)

        top_row = tk.Frame(main_frame, bg="#f8f9fc")
        top_row.pack(fill=tk.X)

        # ハングマン描画
        self.hang_label = tk.Label(top_row, text="", font=("Courier New", 13),
                                   bg="#f0f0f0", justify="left", padx=12, pady=8,
                                   width=16, anchor="nw", relief=tk.SOLID, bd=1)
        self.hang_label.pack(side=tk.LEFT, padx=(0, 16))

        # 右側情報
        right_frame = tk.Frame(top_row, bg="#f8f9fc")
        right_frame.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)

        self.hint_label = tk.Label(right_frame, text="", bg="#f8f9fc",
                                   font=("Noto Sans JP", 10), fg="#888")
        self.hint_label.pack(anchor="w")

        self.word_label = tk.Label(right_frame, text="",
                                   font=("Courier New", 22, "bold"), bg="#f8f9fc")
        self.word_label.pack(anchor="w", pady=(8, 4))

        self.wrong_label = tk.Label(right_frame, text="",
                                    font=("Courier New", 13), bg="#f8f9fc", fg="#e74c3c")
        self.wrong_label.pack(anchor="w")

        self.result_label = tk.Label(right_frame, text="",
                                     font=("Noto Sans JP", 13, "bold"), bg="#f8f9fc")
        self.result_label.pack(anchor="w", pady=4)

        # アルファベットボタン
        alpha_frame = tk.Frame(main_frame, bg="#f8f9fc")
        alpha_frame.pack(pady=(12, 0))
        self.alpha_btns = {}
        for i, c in enumerate("abcdefghijklmnopqrstuvwxyz"):
            btn = tk.Button(alpha_frame, text=c.upper(), width=3,
                            font=("Arial", 10, "bold"),
                            bg="white", activebackground="#dceeff",
                            relief=tk.RAISED, bd=1,
                            command=lambda x=c: self.guess(x))
            btn.grid(row=i // 13, column=i % 13, padx=2, pady=2)
            self.alpha_btns[c] = btn

        ttk.Button(main_frame, text="新しいゲーム", command=self.new_game).pack(pady=(10, 0))

    def new_game(self):
        self.word, self.hint = random.choice(self.WORDS)
        self.guessed = set()
        self.wrong = 0
        self.result_label.config(text="")
        for btn in self.alpha_btns.values():
            btn.config(state=tk.NORMAL, bg="white")
        self._refresh()

    def guess(self, c):
        if c in self.guessed:
            return
        self.guessed.add(c)
        btn = self.alpha_btns[c]
        if c in self.word:
            btn.config(bg="#d4edda", state=tk.DISABLED)
        else:
            self.wrong += 1
            btn.config(bg="#f8d7da", state=tk.DISABLED)
        self._refresh()

    def _refresh(self):
        self.hang_label.config(text=self.HANGMAN[self.wrong])
        self.hint_label.config(text=f"ヒント: {self.hint}")

        display = " ".join(c if c in self.guessed else "_" for c in self.word)
        self.word_label.config(text=display)

        wrong_letters = [c.upper() for c in self.guessed if c not in self.word]
        self.wrong_label.config(
            text=f"ミス ({self.wrong}/{self.MAX_WRONG}): {' '.join(wrong_letters)}")

        if all(c in self.guessed for c in self.word):
            self.result_label.config(text=f"🎉 正解！「{self.word}」", fg="#27ae60")
            for btn in self.alpha_btns.values():
                btn.config(state=tk.DISABLED)
        elif self.wrong >= self.MAX_WRONG:
            self.word_label.config(text=" ".join(self.word))
            self.result_label.config(text=f"😢 ゲームオーバー。答え:「{self.word}」", fg="#e74c3c")
            for btn in self.alpha_btns.values():
                btn.config(state=tk.DISABLED)


if __name__ == "__main__":
    root = tk.Tk()
    app = App45(root)
    root.mainloop()

5. コード解説

ハングマンゲームのコードを、実際に書かれている実装に沿って解説します。

クラス設計とコンストラクタ

App45 クラスにアプリの全機能をまとめています（メソッド5個・全148行）。__init__ ではタイトル「ハングマンゲーム」とウィンドウサイズ 540x480 を設定します。そのあと _build_ui() → new_game() の順に呼び出して初期状態を作ります。