第九单元：事件与事件处理机制

9.1.1 你有一个宠物（You Have a Pet）

9.1.1.1 像 hero 一样指挥 pet Command pet just like hero

本单元最大的惊喜：你有了一个宠物！"边地好伙伴"关卡介绍道："使用 pet 来引用你的宠物，就像使用 hero 引用英雄一样。" 宠物有自己的一套动作，比如 pet.say() 说话、pet.moveXY() 移动、pet.fetch() 取物、pet.findNearestEnemy() 找敌人。它是你在战场上的得力助手。

图1：宠物 pet 和英雄 hero 一样，是可以接受指令的独立单位

但宠物有个特别之处：它不是靠你写一行行命令逐句指挥，而是靠"对事件做出反应"来行动。这就引出了本单元的核心——事件与事件处理机制。

9.1.2 什么是事件（What Is an Event）

9.1.2.1 事件 = 某个时刻发生的事 An event is something that happens

事件（Event）是程序运行过程中某个特定时刻发生的一件事。比如宠物"听到了声音"是一个事件（"hear"），宠物"被召唤出场"也是一个事件（"spawn"）。事件不是你主动调用的，而是在条件满足时自动发起的。

9.1.3 什么是事件处理器（What Is an Event Handler）

9.1.3.1 事件发生时自动执行的函数 A function that runs when an event happens

关卡给出了精准定义："事件处理器是在事件发生时执行的函数。" 换句话说，你预先写好一个函数，告诉系统"当某事件发生，就运行这个函数"。之后你不必盯着，系统会在事件触发时自动调用你的处理器。

9.2.1 on() 的用法（Using on()）

9.2.1.1 把处理器"注册"到事件上 Register a handler to an event

要让宠物对某事件做出反应，需要用 on() 方法把处理器函数"挂"到事件上。关卡讲得很清楚："使用 pet.on(eventType, eventHandler) 为某种事件类型（比如 'hear'）指派事件处理器。" 语法结构如下：

这行代码的含义，用关卡原话说就是："宠物在(on)听到('hear')声音时运行 speak"。第一个参数是事件类型字符串，第二个参数是处理器函数的名字。

9.2.2 别加括号！（Don't Add Parentheses）

9.2.2.1 传"函数本身"，而非"调用结果" Pass the function itself, not its result

这是本单元最关键也最容易错的一点。关卡反复警告："不要为 pet.on('hear', someFunction) 里的 someFunction 加上 ()。() 代表要马上调用函数。我们要的是将一个函数当作参数传递到 .on()，以便之后事件发生时调用，而不是立刻调用。"

pet.on("hear", speak)      # ✓ 正确：传函数的引用
pet.on("hear", speak())    # ✗ 错误：这会立刻执行 speak

9.2.3 处理器的 event 参数（The event Parameter）

9.2.3.1 处理器接收一个事件数据 The handler takes one event argument

关卡提到："该函数需要接受一个参数——事件的相关数据。" 所以事件处理器在定义时，括号里通常写一个形参（习惯命名为 event 或 e），用来接住事件附带的信息。即使暂时用不到这份数据，也要把这个形参留着。

def speak(event):      # 处理器接收事件数据 event
    pet.say("喵~")

pet.on("hear", speak)

9.3.1 hear 何时触发（When "hear" Fires）

9.3.1.1 有人说话且距离够近 When someone nearby speaks

关卡详细描述了触发条件："'hear' 事件会在单位听到声音时发生！只要有人在离单位足够近的位置使用 .say('string') 方法，事件就会发起，处理器函数就会被调用，函数内的代码就会被执行！"

注意三个要点：要有人说话（调用 say）、距离要足够近、然后处理器才会被调用。在一些关卡里，是农民和奶牛在说话，每当它们开口，宠物就会听到并回应。

图2：附近的农民、奶牛或英雄一开口说话，宠物的 "hear" 事件就被触发

9.3.2 让宠物开口回应（Make the Pet Respond）

9.3.2.1 在处理器里写 pet.say() Put pet.say() in the handler

最基本的用法，就是在 "hear" 处理器里让宠物说话。比如训练宠物报出名字、回答问题、礼貌问好。处理器里可以连续 say 多句，宠物会按顺序一句句说出来。

def sayName(event):
    pet.say("我名叫狂兽。")
    pet.say("不过我的朋友们叫我毛球。")

pet.on("hear", sayName)

9.4.1 spawn 只触发一次（"spawn" Fires Only Once）

9.4.1.1 关卡开始、宠物出场的瞬间 The moment the pet appears

"去拿过来"关卡引入了第二种事件："'spawn'（生成）事件只会在关卡开始后，宠物被召唤出来时发生。" 和反复触发的 "hear" 不同，"spawn" 整局只触发一次——就在宠物登场那一刻。

9.4.2 处理器里用循环（Use a Loop in the Handler）

9.4.2.1 一次触发，持续工作 Fire once, work forever

既然 "spawn" 只触发一次，怎么让宠物持续工作呢？关卡给出了巧妙答案："虽然 'spawn' 事件只发生一次，但你还是可以在事件处理器中使用 while 循环重复执行代码。" 在处理器里放一个 while True 循环，宠物登场后就会不知疲倦地循环执行任务。

def goFetch(event):
    while True:                      # 在处理器里循环
        potion = hero.findNearestItem()
        if potion:
            pet.fetch(potion)          # 让宠物去取药水

pet.on("spawn", goFetch)

9.4.3 事件线程：并行运行（Event Threads: Running in Parallel）

9.4.3.1 宠物和英雄各干各的 Pet and hero act independently

"锋利的诱饵"关卡引入了事件线程（Event Thread）这一进阶概念。它的精髓是：事件处理器里的代码，和主循环里的代码是"并行"运行的。也就是说，宠物可以在自己的 spawn 处理器里循环取药水，与此同时，英雄在主循环里循环战斗——两条线同时进行，互不阻塞。

"森林慢跑"也点明了这一点："宠物可以独立于英雄来执行动作。例如，它可以在英雄说话的时候四处移动。" 这种"宠物一条线、英雄一条线"的并行结构，正是事件机制最强大的地方。

图3：宠物的处理器线程与英雄的主循环线程同时运行，互不干扰

这一节聚焦每一关的策略、思路与算法设计，看懂"事件该怎么用"，你就能自己写出完整解法。

9.5.1 边地好伙伴 & 好伙伴的名字系列（Pet Companion Series）

9.5.1.1 策略：注册 hear 处理器让宠物回应 Strategy: register a hear handler to respond

图4：边地好伙伴——英雄一说话,宠物就触发 hear 事件回应

这几关是事件机制的入门。算法思路高度一致:定义一个处理器函数(里面写 pet.say),再用 pet.on("hear", 函数名) 注册。区别只在于宠物说什么、由谁来说话触发。在"好伙伴的名字 A"里,是农民和奶牛说话触发,所以英雄自己不必说话;而在"边地好伙伴"里,需要英雄 hero.say 来触发。

9.5.2 博士猫咪 & 宠物小测试（Doctor Cat & Pet Quiz）

9.5.2.1 策略：用"预设答案"应对所有提问 Strategy: pre-program a fixed answer

图5：博士猫咪——无论问什么数学题,宠物都用同一个处理器回答

这两关让事件回应显得"聪明"。"博士猫咪"的算法妙处在于:所有问题的答案恰好都是 "2",所以处理器 sayTwo 只需固定说 "2"。英雄连问几道难题,每次提问触发一次 hear,宠物每次都答 "2",看起来像在解数学题。"宠物小测试"则要你从头编写 onHear 函数,并多加几句 hero.say 来多次触发,制造问答的连续效果。

9.5.3 去拿过来（Fetch Quest）

9.5.3.1 策略：spawn 处理器 + 循环取物 Strategy: spawn handler + fetch loop

图6：去拿过来——英雄被困,宠物在 spawn 后循环取回药水

这是 "spawn" 事件的首秀。英雄陷入陷阱动弹不得,只能靠宠物。算法思路是:写 goFetch 处理器,内含 while True 循环——不断 findNearestItem 找药水,找到就 pet.fetch(potion) 取回。再用 pet.on("spawn", goFetch) 让宠物一登场就开始干活。

9.5.4 看门狗（Sentinel）

9.5.4.1 策略：宠物自己侦查并示警 Strategy: pet scouts and warns

图7：看门狗——宠物隔河侦查,发现敌人就吠叫提醒工人

这一关展示了宠物的侦查能力。英雄过不了河,但宠物可以。算法思路是:在 spawn 处理器的循环里,用 pet.findNearestEnemy()(宠物也能找敌人!)持续侦查,一旦发现敌人就 pet.say("Woof!") 示警。宠物充当了英雄到不了之处的"眼睛"和"警报器"。

9.5.5 漫漫长路 & 诱饵系列（The Long Way & Bait Levels）

9.5.5.1 策略：英雄主线行动,宠物后台支援 Strategy: hero acts, pet supports in background

图8：漫漫长路——英雄中毒撤离,宠物同时在后台取解药送来

这几关("漫漫长路""坚韧的诱饵""锋利的诱饵")集中体现事件线程的并行威力。共同模式是:用 spawn 处理器让宠物在后台循环取药水,而主循环里英雄同时做别的事——"漫漫长路"里英雄一边移动撤离一边等解药;"坚韧的诱饵"里英雄保持 hero.shield() 当肉盾;"锋利的诱饵"里英雄一边 cleave 战斗。

9.5.6 森林慢跑 & 加农炮之舞（Jogging & Cannon Dance）

9.5.6.1 策略：spawn 处理器驱动宠物巡走 Strategy: spawn handler drives pet movement

图9：森林慢跑——宠物在四个 X 标记间循环跑动,英雄在旁加油

这两关用 spawn 事件控制宠物的移动路线。算法思路是:在 onSpawn 的 while True 循环里,用 pet.moveXY() 依次走过各个标记点,形成循环巡走。与此同时,英雄在自己的主循环里不停 hero.say 加油——这又是一个事件线程并行的典型:宠物跑步线、英雄喊话线同时进行。

9.5.7 充满事件的争论（组合挑战 · Eventful Argument）

9.5.7.1 策略：hear + spawn 双事件协同 Strategy: combine hear and spawn handlers

这是组合挑战,要求把本单元全部本领融会贯通:同时使用 "spawn" 和 "hear" 两个事件来保护村庄。算法思路是注册两个处理器——onSpawn 让宠物循环取物支援,onHear 让宠物在听到说话时回应(关卡提示:回应内容不重要,任何回应都会召来弓箭手帮忙)。主循环里英雄则负责战斗。三条逻辑(宠物取物、宠物回应、英雄战斗)协同运转,共同守住村庄。

pet.on("spawn", onSpawn)   # 宠物登场 → 循环取物
pet.on("hear", onHear)     # 听到说话 → 回应召援
# 主循环：英雄持续战斗（劈斩 / 普攻）

9.6.1 新手最容易踩的坑（Pitfalls for Beginners）

9.6.1.1 事件环节的典型问题 Typical issues with events

图10：给处理器加括号、忘记循环、顺序颠倒,是事件环节最常见的失误