Python Turtle
函数速查手册

向当前朝向前进 distance 个像素。别名：fd()

t.forward(100)  # 前进 100 像素
t.fd(50)       # 等同 forward(50)

向当前朝向的反方向后退 distance 个像素。别名：back() / bk()

t.backward(50)  # 后退 50 像素

向左（逆时针）旋转 angle 度，不移动位置。别名：lt()

t.left(90)   # 左转 90 度（朝上）
t.left(120)  # 三角形用

向右（顺时针）旋转 angle 度。别名：rt()

t.right(90)  # 右转 90 度

直接跳到坐标 (x, y)。原点 (0, 0) 在屏幕中心，右/上为正方向。笔放下时会画线，需配合 penup() 使用。别名：setposition() / setpos()

t.penup()
t.goto(0, 100)   # 跳到上方 100 像素
t.goto(-200, 50)  # 跳到左侧
t.pendown()

只改变 x 或只改变 y 坐标，另一个轴不变。游戏移动控制常用。

t.sety(t.ycor() + 20)  # 向上 20 像素
t.setx(t.xcor() - 20)  # 向左 20 像素

设置绝对朝向角度。0=右，90=上，180=左，270=下。别名：seth()

t.setheading(0)    # 朝右
t.setheading(90)   # 朝上
t.setheading(180)  # 朝左
t.setheading(270)  # 朝下

回到原点 (0, 0) 并将朝向重置为 0°（朝右）。

t.home()  # 回到屏幕中心，朝向归零

抬起画笔——移动时不留痕迹。别名：pu() / up()

t.penup()
t.goto(100, 100)  # 移动不画线

放下画笔——移动时开始画线。别名：pd() / down()

t.pendown()
t.forward(100)  # 画一条线

设置画笔宽度（像素）。默认为 1。别名：width()

t.pensize(3)   # 粗线条
t.pensize(1)   # 细线条（默认）

清除该 turtle 画的所有内容（包括写的文字），但不移动位置。

pen.clear()         # 清除旧分数再重写
pen.write(f"分数:{score}")

清除该 turtle 画的所有内容，并将其重置到初始状态（原点、朝右）。

t.reset()  # 清除 + 回到原点

同时设置画笔颜色和填充颜色。支持颜色名（英文）或十六进制字符串。

t.color("red")       # 颜色名
t.color("#ff4444")   # 十六进制
t.color("pen_c", "fill_c")  # 分别设置

只设置画笔（线条）颜色，不影响填充色。

t.pencolor("blue")    # 线蓝色
t.fillcolor("yellow")  # 填黄色

设置绘图速度。0 = 瞬间完成（最快），1 = 最慢，10 = 很快。

t.speed(0)   # 瞬间完成（推荐游戏用）
t.speed(1)   # 最慢，可以看过程
t.speed(5)   # 中等速度

设置 turtle 的外观形状。可选："turtle" "arrow" "circle" "square" "triangle" "classic"

player.shape("turtle")  # 小海龟形状
player.shape("arrow")   # 箭头
player.shape("circle")  # 圆形

缩放 turtle 的形状大小。默认为 1.0。0.5 = 缩小一半，2 = 放大两倍。

star.shapesize(0.8)     # 稍微缩小
player.shapesize(1.5)  # 放大 1.5 倍

设置填充颜色（与画笔颜色独立）。必须在 begin_fill() 之前调用。

t.fillcolor("lightyellow")  # 设置填色

开始记录填色区域。从此之后画的封闭图形会被填色。

t.fillcolor("tomato")
t.begin_fill()       # 开始记录
for _ in range(4): t.forward(100); t.left(90)
t.end_fill()         # 填充完成

结束填色区域记录，将封闭区域用 fillcolor 的颜色填满。必须与 begin_fill() 配对使用。

t.end_fill()  # 和 begin_fill 配对

返回 turtle 当前的 x 坐标（水平位置）。

x = player.xcor()
player.setx(x + 20)  # 向右移动

返回 turtle 当前的 y 坐标（垂直位置）。

y = player.ycor()
player.sety(y + 20)  # 向上移动

返回当前位置的 (x, y) 元组。别名：position()

x, y = t.pos()
print(t.pos())  # (100.0, 50.0)

返回当前朝向角度（0–360）。

angle = t.heading()  # 当前角度

返回与另一个 turtle 的像素距离。用于碰撞检测：距离 < 阈值 = 碰到了。

if player.distance(star) < 20:
    # 碰到了！

隐藏或显示 turtle 箭头本身。画背景的画笔画完后建议隐藏，画面更干净。别名：ht() / st()

t.hideturtle()  # 画完背景后隐藏
pen.hideturtle() # 计分笔也隐藏

将函数 fn 绑定到按键松开事件。fn 后不加括号！同一按键可重复绑定新函数覆盖旧的。传 None 解除绑定。

turtle.onkey(move_up, "Up")    # ✅ 不加括号
turtle.onkey(move_up(), "Up")  # ❌ 错误写法
turtle.onkey(None, "Up")     # 解除绑定

按住不放时持续触发（onkey 只在松开时触发一次）。角色连续移动用这个更流畅。

turtle.onkeypress(move_up, "Up")
# 按住↑键，角色持续向上移动

让窗口开始接收键盘输入。必须在 onkey 之后调用，否则按键事件不会被捕获。

turtle.onkey(move_up, "Up")
turtle.listen()    # 开启监听，缺了就没反应

延迟 ms 毫秒后调用 fn 一次。1000ms = 1 秒。常用于倒计时、自动更新。

def countdown():
    # 更新倒计时
    turtle.ontimer(countdown, 1000)  # 1秒后再次调用
countdown()  # 启动

保持窗口不关闭。done()：等待用户关闭窗口。mainloop()：进入事件循环，可响应 onkey 等事件。需要键盘交互时必须用 mainloop()。

turtle.done()      # 静态程序用这个
turtle.mainloop()  # 有键盘交互用这个

设置整个画布的背景颜色。

turtle.bgcolor("lightyellow")
turtle.bgcolor("midnightblue")  # 夜晚
turtle.bgcolor("black")

设置窗口标题栏的文字。

turtle.title("我的村子游戏")

设置窗口大小（像素）。默认大约 600×600。

turtle.setup(800, 600)  # 宽800 高600

创建一个新的 turtle 对象。可以有多个（如画图用 t，角色用 player，计分用 pen）。

t      = turtle.Turtle()  # 画背景
player = turtle.Turtle()  # 角色
pen    = turtle.Turtle()  # 计分板
star   = turtle.Turtle()  # 收集物

控制动画更新频率。tracer(0) 关闭自动更新（配合 update() 手动刷新），用于加速复杂绘图。

turtle.tracer(0)        # 关闭自动更新
# ... 大量绘图代码 ...
turtle.update()        # 手动刷新一次

返回或设置画布大小。坐标范围由画布大小决定。

w, h = turtle.screensize()
print(w, h)  # 当前画布宽高