【Python】turtle.fd()のエラーを解決！よくある問題とトラブルシューティング

2025-06-06

turtleモジュールは、Pythonに標準で搭載されているグラフィック描画のためのモジュールです。画面上に「タートル」（カメ）と呼ばれるカーソルを動かすことで、線や図形を描くことができます。

その中で、turtle.fd()はタートルを前方に移動させるためのコマンドです。

`fd`とは？

fdは "forward"（フォワード、前方へ）の略です。

使い方

turtle.fd()は、引数として移動させたい距離（ピクセル単位）を整数または浮動小数点数で指定します。

基本的な構文

turtle.fd(距離)

例

import turtle

# タートルグラフィックの画面を作成
screen = turtle.Screen()
screen.setup(width=600, height=400) # 画面サイズを設定

# タートルオブジェクトを作成
t = turtle.Turtle()

# タートルを100ピクセル前方に移動させる
t.fd(100)

# タートルをさらに50ピクセル前方に移動させる
t.fd(50)

# 画面を閉じるまで待機
screen.mainloop()

上記のコードを実行すると、タートルが最初に100ピクセル、次に50ピクセル、合計150ピクセル前方に移動し、一本の線が描画されます。

turtle.forward()という全く同じ機能を持つ別名もあります。どちらを使っても同じ結果になります。
turtle.fd()は、タートルの現在の向きに従って前方に移動します。もしタートルが右を向いていれば右へ、上を向いていれば上へ移動します。

turtleモジュールは初心者にも非常に使いやすいですが、それでもいくつか一般的な落とし穴があります。

NameError: name 'turtle' is not defined または NameError: name 'fd' is not defined

これは、turtleモジュールが正しくインポートされていない場合に発生します。

エラーの原因

turtle.py という名前で自身のPythonファイルを作成してしまい、標準のturtleモジュールではなく自身のファイルがインポートされてしまっている。
import turtle を使っているのに、fd() のようにプレフィックスなしで呼び出してしまっている。
from turtle import * を使っているのに、turtle.fd() のようにプレフィックスを付けてしまっている。
import turtle を書き忘れた。

対処法

ファイル名がturtle.pyの場合
作成しているPythonファイルの名前をmy_turtle_program.pyのように、turtle.py以外の名前に変更してください。Pythonは現在のディレクトリからモジュールを検索するため、自分で作ったファイルが優先されてしまい、本来のturtleモジュールが読み込まれません。
from turtle import * を使用する場合
turtleの関数を直接呼び出すことができます。ただし、名前の衝突を避けるため、通常はimport turtleの使用が推奨されます。
```
from turtle import *
fd(100) # プレフィックスなしで直接呼び出す
```

import turtle を使用する場合
すべてのturtleコマンドはturtle.プレフィックスを付けて呼び出す必要があります。

import turtle
t = turtle.Turtle() # タートルオブジェクトを作成
t.fd(100)
# または、デフォルトのタートルを使う場合
# turtle.fd(100)

AttributeError: 'module' object has no attribute 'fd' または AttributeError: 'Turtle' object has no attribute 'fd' (大文字・小文字の誤り)

これは、オブジェクトやモジュールの属性にアクセスしようとしたときに、その属性が存在しない場合に発生します。

エラーの原因

turtleモジュール自体をタートルオブジェクトのように扱っている場合（これは稀ですが）。
turtle.Turtle()のように、タートルオブジェクトを正しく作成していない。例えば、t = turtle.turtle()のように、TurtleのTを小文字にしてしまっている場合。

対処法

タートルオブジェクトの生成を確認
turtle.Turtle()のように、Turtleクラスのインスタンスを正しく作成していることを確認してください。
```
import turtle
t = turtle.Turtle() # 正しい記述: TurtleのTは大文字
t.fd(100)
```
もし、turtle.fd(100)のようにデフォルトのタートルを使いたい場合は、タートルオブジェクトを作成する必要はありませんが、turtleモジュールが正しくインポートされているか確認してください。

TypeError: fd() missing 1 required positional argument: 'distance'

これは、fd()関数に必要な引数を渡していない場合に発生します。

エラーの原因

fd()に移動させたい距離の値を渡していない。

対処法

fd()には必ず移動距離を数値で指定してください。

import turtle
t = turtle.Turtle()
t.fd(100) # 100ピクセル前進
# 間違いの例: t.fd()

TypeError: bad operand type for unary -: 'str' または TypeError: can't multiply sequence by non-int of type 'float' (引数の型が間違っている)

これは、fd()に数値以外の引数を渡した場合に発生します。

エラーの原因

fd()に文字列やリストなど、数値を期待される場所に別の型の値を渡してしまった。

対処法

fd()に渡す引数は、必ず整数（int）または浮動小数点数（float）であることを確認してください。

import turtle
t = turtle.Turtle()
distance = 100
t.fd(distance) # 変数でもOK、ただし中身は数値
# 間違いの例: t.fd("100") (文字列)
# 間違いの例: t.fd([100]) (リスト)

ウィンドウがすぐに閉じてしまう / 何も表示されない

これはエラーメッセージではありませんが、よくある問題です。

原因

プログラムがタートル描画を完了した後に、画面を閉じずにすぐに終了してしまうため。

描画が終わった後に、ユーザーがウィンドウを閉じるまでプログラムを待機させるためのコードを追加します。

import turtle

t = turtle.Turtle()
t.fd(100)

turtle.done() # ウィンドウが閉じられるまで待機
# または screen.mainloop() を使用することもできます。
# screen = turtle.Screen()
# screen.mainloop()

turtle.fd()は、タートル（描画カーソル）を現在の向きに沿って前方に移動させる非常に基本的なコマンドです。これ単独でも線が引けますが、他のコマンドと組み合わせることで複雑な図形を描くことができます。

例1：基本的な直線の描画

最も基本的な例です。

import turtle

# 画面のセットアップ (任意: 描画エリアの準備)
screen = turtle.Screen()
screen.setup(width=600, height=400) # 幅600, 高さ400ピクセルの画面を設定
screen.bgcolor("lightblue") # 背景色を水色に設定

# タートルオブジェクトの作成
# これにより、画面上で動かす「カメ」を操作できるようになります
pen = turtle.Turtle()
pen.shape("turtle") # タートルの形状を「カメ」にする (デフォルトは矢印)
pen.color("red")    # ペンの色を赤にする
pen.pensize(3)      # ペンの太さを3ピクセルにする

# タートルを前方に移動させる (線が描かれる)
pen.fd(150) # タートルを150ピクセル前方に移動

# 描画が終わった後、ウィンドウが閉じるまで待機
# これがないと、描画が完了した瞬間にウィンドウが閉じてしまいます
turtle.done()

解説

turtle.done(): これが重要です。プログラムの実行後、すぐにウィンドウが閉じないように、ユーザーが手動でウィンドウを閉じるまで待機させます。
pen.fd(150): タートルを現在向いている方向に150ピクセル進めます。このとき、ペンが下りている状態なので、線が描かれます。
pen.shape("turtle")、pen.color("red")、pen.pensize(3): タートルの見た目や描画する線のスタイルを設定しています。
pen = turtle.Turtle(): タートル（ペン）オブジェクトを作成します。これでpenという名前でタートルを操作できます。
screen.setup(...)、screen.bgcolor(...): 画面のサイズや背景色を設定しています。
screen = turtle.Screen(): 描画が行われる画面オブジェクトを作成します。
import turtle: turtleモジュールをプログラムに読み込みます。

例2：四角形の描画

fd()とright()（またはleft()）を組み合わせて、図形を描きます。

import turtle

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

pen = turtle.Turtle()
pen.shape("arrow") # 形を矢印に
pen.color("blue")
pen.pensize(2)

# 四角形を描くループ
for _ in range(4): # 4回繰り返す
    pen.fd(100)      # 100ピクセル前進
    pen.right(90)    # 右に90度回転 (真下を向く)

turtle.done()

解説

pen.right(90): 右に90度回転します。これにより、次のfd()で直角の辺が描かれます。これを4回繰り返すことで四角形が完成します。
pen.fd(100): 辺の長さを100ピクセルにして前進します。
for _ in range(4):: 4回繰り返し処理を行います。_はループ変数を使わない場合に慣習的に使われます。

例3：多角形の描画 (関数とループの利用)

任意の辺の数の多角形を描く例です。

import turtle

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

pen = turtle.Turtle()
pen.speed(5) # 描画速度を設定 (1:遅い, 10:速い, 0:最速)
pen.pensize(3)
pen.color("purple")

def draw_polygon(sides, length):
    """
    指定された辺の数と長さで正多角形を描画する関数
    """
    angle = 360 / sides # 内角の計算
    for _ in range(sides):
        pen.fd(length)
        pen.right(angle)

# 正三角形を描画
pen.penup() # ペンを上げる (線を引かずに移動)
pen.goto(-100, 50) # 移動
pen.pendown() # ペンを下げる (線を引き始める)
draw_polygon(3, 100) # 3辺、各辺の長さ100ピクセルの三角形

# 正六角形を描画
pen.penup()
pen.goto(50, -50)
pen.pendown()
draw_polygon(6, 70) # 6辺、各辺の長さ70ピクセルの六角形

turtle.done()

解説

pen.goto(x, y): 指定した座標にタートルを移動させます。
pen.penup() / pen.pendown():
- penup(): ペンを上げて、移動しても線が描かれないようにします。
- pendown(): ペンを下ろして、移動すると線が描かれるようにします。
angle = 360 / sides: 正多角形の内角（タートルが曲がる角度）は360度 / 辺の数で計算できます。
def draw_polygon(sides, length):: 正多角形を描くための関数を定義しています。引数で辺の数と長さを指定できます。
pen.speed(5): タートルの描画速度を制御します。数値が大きいほど速くなります。

例4：星形を描く

fd()とright()の組み合わせで、より複雑な図形も描けます。

import turtle

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

pen = turtle.Turtle()
pen.color("gold") # 星の色を金色に
pen.pensize(2)
pen.speed(0) # 最速で描画

# 星形を描く (五芒星)
for _ in range(5):
    pen.fd(200)      # 200ピクセル前進
    pen.right(144)   # 右に144度回転 (星の角度)

turtle.done()

星形（五芒星）を描くには、fd()で線を引いた後、144度回転することを5回繰り返します。これは360 / 5 * 2 = 144という計算から来ています（2は、内側を飛び越える辺の数を意味します）。

turtle.fd()はタートルを「現在の向きに沿って」前進させる最も基本的な方法ですが、タートルを移動させる方法は他にもいくつかあり、それぞれ異なる用途で便利です。

turtle.forward(distance)

これは最も直接的な代替方法であり、機能的にはturtle.fd(distance)と全く同じです。 fdはforwardの略であり、両者は完全に同義語です。

特徴

引数は距離（ピクセル単位）です。
タートルの現在の向きに沿って指定された距離だけ前進します。

使用例

import turtle

t = turtle.Turtle()
t.forward(100) # fd(100)と同じ
turtle.done()

いつ使うか

fd()と同じ状況で、コードの可読性を高めたい場合（forwardの方がfdよりも意味が分かりやすいと感じる人もいます）。

turtle.backward(distance) または turtle.bk(distance)

タートルを現在の向きと逆方向に移動させます。つまり、後退させます。bkはbackwardの略です。

特徴

引数は距離（ピクセル単位）です。
fd()やforward()とは異なり、逆方向に移動します。

使用例

import turtle

t = turtle.Turtle()
t.pensize(2)

t.fd(50)  # 前に50進む
t.backward(100) # 後ろに100戻る (元の位置より50後ろになる)
t.fd(50)  # また前に50進む (元の位置に戻る)

turtle.done()

いつ使うか

タートルを後退させたい場合。特に、現在の向きを変えずに後ろに移動したい場合に便利です。

turtle.setx(x) / turtle.sety(y) / turtle.setheading(angle)

これらはタートルの位置や向きを直接設定するコマンドです。

turtle.setheading(angle) または turtle.seth(angle): タートルの向きを直接設定します。角度は度数で指定し、0度は東（右）、90度は北（上）、180度は西（左）、270度は南（下）となります。
turtle.sety(y): タートルのY座標を直接設定します。X座標は変わりません。
turtle.setx(x): タートルのX座標を直接設定します。Y座標は変わりません。

特徴

現在の位置や向きに関わらず、指定された新しい位置や向きに瞬時に設定できます（ペンが下りていれば線が引かれます）。

使用例

import turtle

t = turtle.Turtle()
t.pensize(2)

t.setx(100) # X座標を100に設定 (右へ移動)
t.sety(50)  # Y座標を50に設定 (上へ移動)

t.penup()    # ペンを上げる (線を引かずに移動)
t.setheading(90) # 北（上）を向く
t.fd(50)     # 上に50進む (線は引かれない)
t.pendown()  # ペンを下ろす
t.fd(50)     # さらに上に50進む (線が引かれる)

turtle.done()

いつ使うか

タートルの向きを特定の角度に直接設定したい場合。
特定の絶対座標にタートルを移動させたい場合。

turtle.goto(x, y) または turtle.setposition(x, y) / turtle.setpos(x, y)

タートルを指定された絶対座標(x, y)に移動させます。

特徴

ペンが下りていれば、現在の位置から指定された座標まで線が引かれます。
fd()が「どれだけ進むか」なのに対し、goto()は「どこへ行くか」を指定します。

使用例

import turtle

t = turtle.Turtle()
t.pensize(2)
t.speed(1) # 遅めに設定して移動を確認

t.goto(100, 100) # (0,0)から(100,100)まで線を引きながら移動
t.goto(-100, 100) # (100,100)から(-100,100)まで移動
t.goto(-100, -100) # (-100,100)から(-100,-100)まで移動
t.goto(0, 0) # 中心に戻る

turtle.done()

いつ使うか

座標系を使って描画位置を厳密に制御したい場合。
複数の特定の点を結んで図形を描きたい場合。

turtle.circle(radius, extent=None, steps=None)

これは直接的な移動というよりは、円弧を描くためのコマンドですが、タートルは円弧に沿って移動します。

特徴

steps引数で円弧を構成する線のセグメント数を指定でき、多角形を描く際に便利です。
extent引数で描く円弧の角度を指定できます（省略すると完全な円）。
半径を指定して円弧（または完全な円）を描きます。

使用例

import turtle

t = turtle.Turtle()
t.pensize(2)
t.speed(0)

# 半径50の円を時計回りに描く
t.circle(50)

# 半径100、角度180度（半円）を時計回りに描く
t.penup()
t.goto(-100, 0)
t.pendown()
t.circle(100, 180)

# 半径-80（反時計回り）、完全な円
t.penup()
t.goto(50, -50)
t.pendown()
t.circle(-80)

turtle.done()

stepsを使って正多角形を効率的に描きたい場合。
円や円弧を描きたい場合。

Pythonグラフィックプログラミング：Turtle以外の選択肢（Tkinter, Pygame他）

「タートル」（亀）と呼ばれる小さなロボットが画面上を動き回り、その軌跡に沿って線を描いていく様子を想像してください。このタートルに命令を与えることで、様々な図形や模様を描くことができます。視覚的にプログラミングの結果がすぐに確認できるため、特に子供やプログラミングの基本概念を学ぶのに適しています。

Python Turtleグラフィック完全ガイド：メソッドと関数の使い方

Pythonのturtleモジュールは、グラフィック描画を簡単に行うための機能を提供します。このモジュールには、基本的な描画オブジェクトである「タートル」を制御するための様々なメソッドや関数が用意されています。大きく分けて、タートルを制御する方法には以下の2種類があります。

Methods of TurtleScreen/Screen and corresponding functions (turtle)

turtleモジュールは、グラフィカルな描画を簡単に行うためのPythonの標準ライブラリです。カメ（タートル）が画面上を移動しながら線を描く様子をシミュレートします。このモジュールには、描画を行う「カメ」と、そのカメが活動する「画面」という2つの主要な要素があります。

Python Turtleとは？初心者向けグラフィックプログラミング入門

Pythonのturtleモジュールは、グラフィック描画を簡単に行うためのモジュールです。Logoプログラミング言語にインスパイアされており、"タートル"と呼ばれる小さなカーソルを動かすことで線や図形を描くことができます。そして、turtledemoは、このturtleモジュールの使い方を示すデモスクリプト集です。これはPythonの標準ライブラリの一部として含まれており、turtleモジュールの様々な機能や、それを使ってどのような面白いグラフィックが描けるかを示すためのたくさんのサンプルプログラムが用意されています。

【Python】turtle.fd()のエラーを解決！よくある問題とトラブルシューティング

fdとは？

使い方

NameError: name 'turtle' is not defined または NameError: name 'fd' is not defined

AttributeError: 'module' object has no attribute 'fd' または AttributeError: 'Turtle' object has no attribute 'fd' (大文字・小文字の誤り)

TypeError: fd() missing 1 required positional argument: 'distance'

TypeError: bad operand type for unary -: 'str' または TypeError: can't multiply sequence by non-int of type 'float' (引数の型が間違っている)

ウィンドウがすぐに閉じてしまう / 何も表示されない

例1：基本的な直線の描画

例2：四角形の描画

例3：多角形の描画 (関数とループの利用)

例4：星形を描く

turtle.forward(distance)

turtle.backward(distance) または turtle.bk(distance)

turtle.setx(x) / turtle.sety(y) / turtle.setheading(angle)

turtle.goto(x, y) または turtle.setposition(x, y) / turtle.setpos(x, y)

turtle.circle(radius, extent=None, steps=None)

`fd`とは？