挫折しないPython Turtle!よくあるエラーとその解決策

2025-06-06

Pythonの「turtle」とは?

Pythonの turtle モジュールは、画面上に「亀(タートル)」と呼ばれる小さなカーソルを動かし、その軌跡に沿って線を描画することで、図形や絵を作成できるグラフィックスライブラリです。まるで小さなロボットを操作して絵を描くようにプログラミングできるため、視覚的にコードの動きを理解しやすいのが特徴です。

主な特徴とできること

  1. 直感的な操作:

    • 亀を前進させたり (forward())、後退させたり (backward())、左右に回転させたり (right(), left()) する簡単なコマンドで操作できます。
    • これらの動きに合わせて、画面に線が描かれていきます。
  2. 図形の描画:

    • 四角形、三角形、円などの基本的な図形を簡単に描くことができます。ループ処理 (for 文) と組み合わせることで、複雑なパターンやフラクタル図形を描画することも可能です。
  3. 色の変更:

    • 線の色 (pencolor()) や塗りつぶしの色 (fillcolor()) を自由に変更できます。
    • 図形を塗りつぶす機能 (begin_fill(), end_fill()) もあります。
  4. ペン操作:

    • ペンを上げたり (penup())、下げたり (pendown()) することで、線を描かずに亀を移動させることができます。これにより、点線を描いたり、離れた場所に移動して新しい図形を描き始めたりできます。
  5. 速度の調整:

    • 亀の動きの速さ (speed()) を調整できるため、描画過程をゆっくり観察したり、素早く結果を表示したりできます。
  6. イベント処理:

    • クリックイベントなど、ユーザーの操作に応じて亀を動かすようなインタラクティブなプログラムも作成可能です。

なぜ「turtle」が使われるのか?

  • デバッグのしやすさ: コードの誤りが視覚的に確認しやすいため、デバッグの練習にもなります。
  • 創造性の育成: 自由に図形やパターンを描けるため、子供から大人まで、創造性を発揮しながらプログラミングに取り組むことができます。
  • 学習のしやすさ: コードが視覚的な結果に直結するため、プログラミングの基本的な概念(シーケンス、ループ、条件分岐など)を楽しく学ぶことができます。
import turtle # turtleモジュールをインポート

wn = turtle.Screen() # 画面を作成
wn.bgcolor("lightblue") # 背景色を設定

t = turtle.Turtle() # 亀のオブジェクトを作成
t.pensize(3) # ペンの太さを設定
t.color("red") # ペンの色を設定

t.forward(100) # 100ピクセル前進
t.left(90) # 左に90度回転
t.forward(100) # 100ピクセル前進

wn.exitonclick() # クリックで画面を閉じる

このコードを実行すると、赤い線でL字型の図形が描画されます。



Python turtle のよくあるエラーとトラブルシューティング

モジュールのインポートと初期化に関するエラー

エラーメッセージ例

  • AttributeError: module 'turtle' has no attribute 'Screen'
  • NameError: name 'turtle' is not defined

原因と解決策

  • AttributeError: ... 'Screen' (または他のオブジェクト名)
    大文字と小文字の区別や、オブジェクトの作成方法が間違っています。Pythonは大文字と小文字を厳密に区別します。Screen()Turtle() の頭文字は大文字である必要があります。

    • 解決策
      正しいスペルと大文字・小文字で記述してください。

    • # 正しい記述
      screen = turtle.Screen()
      my_turtle = turtle.Turtle()
      
      # 間違いの例: turtle.screen() や turtle.turtle() はエラー
      
  • NameError
    turtle モジュールを使用する前にインポートを忘れています。

    • 解決策
      スクリプトの冒頭で必ず import turtle を記述してください。

    • import turtle # これを忘れない!
      
      # ...後のコード...
      

タートルコマンド(メソッド)に関するエラー

エラーメッセージ例

  • TypeError: forward() missing 1 required positional argument: 'distance'
  • AttributeError: 'Turtle' object has no attribute 'foward'

原因と解決策

  • グローバル関数とオブジェクト指向メソッドの混同
    turtle には、import turtle してオブジェクト(例: t = turtle.Turtle()) を作成し、t.forward() のように呼び出す方法と、from turtle import * を使って直接 forward() と呼び出す古い(非推奨)な方法があります。両者を混同するとエラーになります。

    • 解決策
      一貫した方法を使用してください。通常は import turtle を使用し、タートルオブジェクトを作成してそのメソッドを呼び出すのが推奨されます。

    • import turtle
      my_pen = turtle.Turtle()
      my_pen.forward(50) # 推奨される書き方
      
      # from turtle import * を使っている場合のみ有効
      # forward(50)
      
  • 引数(ひきすう)の不足または過剰
    メソッドが要求する引数を渡していないか、誤った数の引数を渡しています。例えば、forward() は距離が必要です。

    • 解決策
      各コマンドが必要とする引数の数と型(数値、文字列など)を確認し、正しく渡してください。

    • t.forward() はエラー、t.forward(100) は正しい。t.left(90) は正しいが、t.left() はエラー。
  • スペルミスやメソッド名の間違い
    forwardfoward のように間違えたり、存在しないメソッドを呼び出そうとしたりしています。

    • 解決策
      コマンドの正しいスペルを確認してください。公式ドキュメントやリファレンスを参照するのが確実です。

    • t.forward(100) は正しいが、t.foward(100) はエラー。

画面(ウィンドウ)の表示と終了に関するエラー

問題

  • turtleのウィンドウがクリックしても閉じない。
  • turtleのウィンドウが表示されない。
  • turtleのウィンドウがすぐに閉じてしまい、描画結果が見えない。

原因と解決策

  • 画面がクリックしても閉じない
    turtle.exitonclick() を使用していない場合、クリックイベントは監視されません。

    • 解決策
      クリックで閉じたい場合は、必ず turtle.exitonclick() を使用してください。
  • 画面が表示されない
    turtle.Screen() オブジェクトが作成されていないか、turtle.mainloop() (または turtle.done() など)が呼ばれていない可能性があります。

    • 解決策
      screen = turtle.Screen() のように画面オブジェクトを作成し、スクリプトの最後に画面を保持するコマンドを記述しているか確認してください。
  • 画面がすぐに閉じる
    Pythonスクリプトの実行が終了すると、turtleのウィンドウも自動的に閉じます。描画が終わった後に一時停止するコマンドが必要です。

    • 解決策
      コードの最後に turtle.done() または turtle.exitonclick() を追加してください。
      • turtle.done(): 画面を閉じずに待機します。スクリプトを強制終了するまで開いたままです。
      • turtle.exitonclick(): 画面がクリックされるまで待機し、クリックされると閉じます。

    • # ...描画コード...
      
      turtle.done() # または turtle.exitonclick()
      

論理的エラーとデバッグのヒント

問題

  • 何も描画されない(しかしエラーは出ない)。
  • 描画される図形が期待と異なる。
  • タートルが意図しない方向に動く。

原因と解決策

  • ループの回数や条件の間違い
    for ループや while ループを使って繰り返す場合、ループの回数や条件が間違っていると、図形が完成しなかったり、無限ループに陥ったりすることがあります。

    • 解決策
      ループの範囲や終了条件を再確認してください。
  • ペンの上げ下げ忘れ (penup(), pendown())
    線を描きたくない場所でペンを上げ忘れ、意図しない線が引かれてしまうことがあります。

    • 解決策
      線を描かないで移動したいときは t.penup() を呼び出し、再び線を描きたいときは t.pendown() を呼び出しているか確認してください。
  • 角度や距離の計算ミス

    • 解決策
      • left()right() の角度が正しいか確認してください。例えば、正方形は90度ずつ曲がります。
      • forward()backward() の距離が正しいか確認してください。
      • デバッグのために、print() 文を使ってタートルの現在の方向 (t.heading()) や座標 (t.pos()) を表示してみると役立ちます。
  1. エラーメッセージをよく読む
    Pythonのエラーメッセージは、エラーの種類と発生したコードの行番号を示しています。ここから問題の手がかりを得るのが第一歩です。
  2. コードを一行ずつ確認する
    特に複雑な図形を描いている場合、シンプルな部分からステップバイステップでコードを追っていき、どこで期待と異なる動きをしているかを見つけます。
  3. シンプルなコードで試す
    複雑なプログラムでエラーが出た場合、原因を特定するために、問題が起こっていると思われる部分だけを抜き出して、最もシンプルなコードで試してみましょう。
  4. 公式ドキュメントやオンラインリソースを活用する
    Pythonの公式ドキュメントや、Stack Overflow、Qiitaなどのオンラインコミュニティで同じようなエラーが出ていないか検索してみましょう。
  5. IDEやエディタの機能を使う
    コード補完機能やシンタックスハイライト(色分け表示)は、スペルミスや大文字・小文字の間違いを見つけるのに役立ちます。


基本的なセットアップと直線を描く

最もシンプルなコードで、turtleのウィンドウを表示し、亀を動かして直線を描きます。

import turtle # ① turtleモジュールをインポート

# ② 画面(スクリーン)のセットアップ
screen = turtle.Screen()
screen.setup(width=600, height=400) # ウィンドウのサイズを設定
screen.bgcolor("lightgreen")        # 背景色を設定

# ③ 亀(タートル)のオブジェクトを作成
my_turtle = turtle.Turtle()
my_turtle.shape("turtle") # 亀の形にする
my_turtle.color("blue")   # 亀の色を設定
my_turtle.pensize(2)      # ペンの太さを設定

# ④ 亀を動かして直線を描く
my_turtle.forward(150) # 150ピクセル前進

# ⑤ ウィンドウがクリックされるまで開いたままにする
screen.exitonclick()

解説

  • screen.exitonclick(): ユーザーが画面をクリックするまでウィンドウを閉じずに待機します。
  • forward(): 指定された距離だけ亀を前進させ、線を引きます。
  • turtle.Turtle(): 実際に描画を行う「亀」を作成します。
  • turtle.Screen(): 描画するキャンバス(画面)を作成します。
  • import turtle: turtleモジュールを使うための必須の宣言です。

四角形を描く

ループを使って、複数の辺と角を持つ図形を描きます。

import turtle

screen = turtle.Screen()
screen.setup(width=400, height=400)
screen.bgcolor("skyblue")

drawer = turtle.Turtle()
drawer.shape("arrow")
drawer.color("purple")
drawer.pensize(3)
drawer.speed(1) # 亀の動きを遅くして描画過程が見えるようにする

# 四角形を描く(4回繰り返す)
for _ in range(4): # _ はループ内で変数を使わない場合に慣習的に使われる
    drawer.forward(100) # 100ピクセル前進
    drawer.right(90)    # 右に90度回転

screen.exitonclick()

解説

  • speed(1): 亀の動きの速度を設定します。0(最速)から10(速い)、1(遅い)までの範囲で設定できます。描画過程を見たいときに便利です。
  • right(90): 亀を右に90度回転させます。left(90)を使えば左に回転します。
  • for _ in range(4):: 4回繰り返すループです。四角形は4つの辺と4つの角を持つため、この回数で適切に描画できます。

星形を描く

線の色を変えたり、ペンを上げ下げして線を引かずに移動したりする例です。

import turtle

screen = turtle.Screen()
screen.setup(width=500, height=500)
screen.bgcolor("black")

star_drawer = turtle.Turtle()
star_drawer.pensize(2)
star_drawer.speed(5) # 少し速く

# 亀を初期位置に移動(線を引かずに)
star_drawer.penup()      # ペンを上げる(線を引かない)
star_drawer.goto(0, 150) # 座標(0, 150)へ移動
star_drawer.pendown()    # ペンを下げる(線を引く)

# 星形を描く(5回繰り返す)
star_drawer.color("gold") # ペンの色を金色に設定
for i in range(5):
    star_drawer.forward(300) # 300ピクセル前進
    star_drawer.right(144)   # 右に144度回転(星の角度)

screen.exitonclick()

解説

  • color("gold"): ペンの色を文字列で指定します("red", "blue", "green"など)。
  • goto(x, y): 亀を直接指定した座標(x, y)に移動させます。
  • pendown(): ペンを画面に下ろし、再び線が引かれるようにします。
  • penup(): ペンを画面から上げ、移動しても線が引かれないようにします。

円を描く

circle()メソッドを使って簡単に円を描きます。塗りつぶしの機能も使います。

import turtle

screen = turtle.Screen()
screen.setup(width=500, height=500)
screen.bgcolor("white")

circle_maker = turtle.Turtle()
circle_maker.shape("circle") # 亀の形を円にする
circle_maker.pensize(3)
circle_maker.speed(0) # 最速

# 円を塗りつぶして描く
circle_maker.color("blue", "lightblue") # 線の色, 塗りつぶしの色
circle_maker.begin_fill() # 塗りつぶしを開始
circle_maker.circle(100)   # 半径100の円を描く
circle_maker.end_fill()   # 塗りつぶしを終了

# 少し移動して別の円を描く
circle_maker.penup()
circle_maker.goto(-150, 0)
circle_maker.pendown()

circle_maker.color("red", "salmon")
circle_maker.begin_fill()
circle_maker.circle(70)
circle_maker.end_fill()

screen.exitonclick()

解説

  • end_fill(): begin_fill() の後に描かれた最後の閉じた図形を、設定された色で塗りつぶします。
  • begin_fill(): このコマンドの後に描かれる図形を塗りつぶしの対象としてマークします。
  • color(pencolor, fillcolor): ペンの色と、図形を塗りつぶす際の色を同時に設定できます。
  • circle(radius): 指定された半径の円を描きます。

関数を使って図形を描く(多角形ジェネレーター)

繰り返し使う描画パターンを関数として定義することで、コードを整理し、再利用しやすくなります。

import turtle

screen = turtle.Screen()
screen.setup(width=600, height=600)
screen.bgcolor("darkgrey")

artist = turtle.Turtle()
artist.pensize(2)
artist.speed(0) # 最速

# 多角形を描く関数を定義
def draw_polygon(sides, size, color_name):
    artist.color(color_name)
    angle = 360 / sides # 内角を計算
    for _ in range(sides):
        artist.forward(size)
        artist.right(angle)

# いろいろな多角形を描いてみる
artist.penup()
artist.goto(-200, 100)
artist.pendown()
draw_polygon(3, 100, "red") # 三角形

artist.penup()
artist.goto(0, 100)
artist.pendown()
draw_polygon(4, 100, "blue") # 四角形

artist.penup()
artist.goto(200, 100)
artist.pendown()
draw_polygon(5, 100, "green") # 五角形

artist.penup()
artist.goto(-100, -100)
artist.pendown()
draw_polygon(8, 70, "purple") # 八角形

screen.exitonclick()
  • 関数を使うことで、同じロジックを何度も書くことなく、異なるパラメータで様々な多角形を簡単に描けるようになります。
  • angle = 360 / sides: 多角形の外角は 360度 / 辺の数 で計算できます。
  • def draw_polygon(sides, size, color_name):: draw_polygonという名前の関数を定義しています。sides(辺の数)、size(辺の長さ)、color_name(色)を引数として受け取ります。


PyGame (パイゲーム)

PyGameは、Pythonでゲーム開発を行うためのライブラリとして非常に有名ですが、インタラクティブなグラフィックスやアニメーションの描画にも非常に適しています。

  • 簡単なコード例:
    import pygame # PyGameモジュールをインポート
    
    # PyGameの初期化
    pygame.init()
    
    # 画面サイズの設定
    screen_width = 800
    screen_height = 600
    screen = pygame.display.set_mode((screen_width, screen_height))
    pygame.display.set_caption("PyGameでの描画例") # ウィンドウのタイトル
    
    # 色の定義 (RGB)
    WHITE = (255, 255, 255)
    RED = (255, 0, 0)
    BLUE = (0, 0, 255)
    
    running = True
    while running: # ゲームループ(イベントを処理し続ける)
        for event in pygame.event.get():
            if event.type == pygame.QUIT: # ウィンドウの閉じるボタンが押されたら
                running = False
    
        # 画面を白で塗りつぶす
        screen.fill(WHITE)
    
        # 赤い四角形を描画 (画面, 色, (x, y, 幅, 高さ))
        pygame.draw.rect(screen, RED, (100, 100, 150, 150))
    
        # 青い円を描画 (画面, 色, (中心x, 中心y), 半径, 太さ(0で塗りつぶし))
        pygame.draw.circle(screen, BLUE, (400, 300), 70, 5)
    
        # 描画したものを画面に反映
        pygame.display.flip()
    
    pygame.quit() # PyGameを終了
    
  • Turtleからの移行点: turtleが直感的に「亀を動かす」のに対し、PyGameはより「画面をピクセル単位で操作する」感覚に近いです。イベントループ(ユーザーの入力や時間経過を監視し続ける処理)の概念が必須になります。
  • 特徴:
    • 高速な描画が可能。
    • キーボードやマウス入力などのイベント処理が容易。
    • 画像、音声、動画の扱いにも対応。
    • ゲームループの概念を学ぶのに最適。

Tkinter (Canvasウィジェット)

TkinterはPythonに標準で付属しているGUIライブラリです。その中のCanvasウィジェットは、簡単な図形描画に特化しており、turtleに似た感覚で使える部分もあります。

  • 簡単なコード例:
    import tkinter as tk # Tkinterをインポート
    
    # メインウィンドウの作成
    root = tk.Tk()
    root.title("Tkinter Canvas描画例")
    
    # Canvasウィジェットの作成 (描画領域)
    canvas = tk.Canvas(root, width=500, height=400, bg="lightyellow")
    canvas.pack() # ウィンドウに配置
    
    # 直線を描画 (x1, y1, x2, y2, 色, 太さ)
    canvas.create_line(50, 50, 200, 200, fill="red", width=3)
    
    # 四角形を描画 (x1, y1, x2, y2, 色, 枠の色)
    canvas.create_rectangle(250, 50, 450, 150, fill="blue", outline="darkblue")
    
    # 円を描画 (x1, y1, x2, y2 はバウンディングボックスの座標, 色, 枠の色)
    # create_ovalは楕円を描くが、正方形のバウンディングボックスで円になる
    canvas.create_oval(100, 250, 200, 350, fill="green", outline="darkgreen", width=2)
    
    # テキストを描画
    canvas.create_text(350, 300, text="Tkinter Canvas", font=("Arial", 16), fill="purple")
    
    # メインループの開始(ウィンドウを開いたままにする)
    root.mainloop()
    
  • Turtleからの移行点: turtleが単独でグラフィックスウィンドウを生成するのに対し、Tkinterは一般的なGUIアプリケーションの中に描画領域(Canvas)を作る形です。イベント処理はTkinterのメインループが管理します。
  • 特徴:
    • Pythonに標準搭載されており、追加インストールが不要。
    • ボタンやテキストボックスなどのGUIコンポーネントと組み合わせて使える。
    • Canvasウィジェット上で直線、円、四角形などの図形を描画できる。

Matplotlib (マットプロットリブ)

Matplotlibは主に科学技術計算のグラフ描画に使われるライブラリですが、図形(線、円、多角形など)を描画する機能も持っています。インタラクティブな描画やゲームには不向きですが、静的な図の作成には非常に強力です。

  • 簡単なコード例:
    import matplotlib.pyplot as plt # Matplotlibをインポート
    import matplotlib.patches as patches # 図形描画用のモジュール
    
    # 図と軸を作成
    fig, ax = plt.subplots(1)
    ax.set_xlim(0, 10) # X軸の範囲
    ax.set_ylim(0, 10) # Y軸の範囲
    ax.set_aspect('equal', adjustable='box') # 縦横比を固定
    
    # 赤い四角形を追加 (左下隅のx, y, 幅, 高さ)
    rect = patches.Rectangle((1, 1), 3, 3, linewidth=2, edgecolor='r', facecolor='none')
    ax.add_patch(rect)
    
    # 青い円を追加 (中心x, 中心y, 半径)
    circle = patches.Circle((7, 7), 2, linewidth=2, edgecolor='b', facecolor='lightblue')
    ax.add_patch(circle)
    
    # 緑の直線を描画 (x座標のリスト, y座標のリスト)
    ax.plot([2, 8], [8, 2], color='g', linestyle='--', linewidth=3)
    
    # 図を表示
    plt.show()
    
  • Turtleからの移行点: turtleが「亀を動かして描く」のに対し、Matplotlibは「座標系上に図形を配置して描く」感覚です。描画は基本的に静的であり、リアルタイムなインタラクションには向いていません。
  • 特徴:
    • 論文発表品質のグラフ作成が可能。
    • 数値計算ライブラリ(NumPyなど)との連携が容易。
    • 直線、曲線、パッチ(多角形など)の描画機能を持つ。

PyQt / PySide (パイキューティー / パイサイド)

QtというC++製の強力なGUIフレームワークをPythonから利用するためのバインディングです。非常に高機能で複雑なグラフィックスやGUIアプリケーションの開発に使われます。

  • Turtleからの移行点: 学習コストはこれらの中で最も高いですが、本格的なデスクトップアプリケーションや、CADソフトウェアのような複雑な描画アプリケーションを作る場合には最適です。
  • 特徴:
    • プロフェッショナルなレベルのGUIを作成可能。
    • グラフィックスビューフレームワークを使った高度な描画。
    • WebEngine、データベース連携など、非常に多機能。
  • PyQt / PySide: プロフェッショナルなGUIアプリケーション、高度な描画、大規模プロジェクト。
  • Matplotlib: 静的なグラフ、データ可視化、科学技術系の図作成。
  • Tkinter (Canvas): Python標準のGUIアプリ、簡単な図形描画、他のGUIコンポーネントとの組み合わせ。
  • PyGame: 2Dゲーム開発、インタラクティブなアニメーション、リアルタイム描画。
  • turtle: プログラミング入門、簡単な図形描画、学習用。