第六单元：函数的定义与调用

6.1.1 重复劳动的烦恼（The Pain of Repetition）

6.1.1.1 巡逻这件"无聊事" Patrolling is boring repetition

在"乡村巡游者"关卡里，英雄要在村庄的几个入口之间来回巡逻、清剿敌人。关卡一开始就点出了痛点："在村庄中巡逻是很无聊的重复工作。" 每到一个巡逻点，你都要重复写"找敌人 → 判断 → 攻击"这同样的几行代码——点越多，重复得越多，代码又长又乱。

有没有办法只写一次这套逻辑，然后到处反复使用？有！这就是本单元的主角：函数（Function）。关卡说得很直白："使用函数可以让重复工作轻松许多。你可以将很多行代码放到一行里！"

6.1.2 函数的三大好处（Three Benefits of Functions）

6.1.2.1 浓缩、复用、易读 Condense, reuse, readable

函数为什么这么重要？因为它一次性带来了三个好处：

关卡里有一句很形象的话："这是函数的第一大好处：它们能将大量代码浓缩到一行。" 想象一下，如果每次挥剑都要写 25 行代码，那将是怎样的灾难！

6.1.3 你早就在用函数（You've Been Using Functions）

6.1.3.1 attack 其实就是一个函数 attack is already a function

其实，你一直都在用函数，只是没意识到。关卡揭晓了真相：当你写 hero.attack(enemy) 时，"这是在调用（calling 或者说 invoking）一个函数，名为 attack。"

本单元最大的跃迁是：你将从"只会调用别人写好的函数"，升级到"定义自己的函数"。

6.2.1 函数的定义（Definition）

6.2.1.1 一段可以重复使用的代码 A reusable block of code

图1：函数就是把一组动作打包、贴上名字，之后随时一键调用

函数（Function）是一段被命名、可以重复使用的代码。你把若干行代码"打包"在一起，给这个包起个名字；以后任何时候想运行这段代码，只要喊一声这个名字就行。关卡说："函数是代码的重要组成部分。"

6.2.2 函数名与函数体（Name and Body）

6.2.2.1 函数由两部分组成 A function has two parts

关卡明确指出："定义一个函数，它含有两部分：函数名和函数体。"

有时函数还会带参数（Parameter）——比如 attack(enemy) 括号里的 enemy。不过本单元先专注于不带参数的函数，参数留到以后的单元再深入。

6.2.3 黑箱比喻（The Black Box）

6.2.3.1 像一台贴了标签的机器 Like a labeled machine

6.3.1 def 关键字（The def Keyword）

6.3.1.1 用 def 开启一个定义 Start a definition with def

在 Python 里，定义函数要用关键字 def（define 的缩写，意为"定义"）。基本格式是：

def 函数名():
    # 函数体：调用时要执行的代码（缩进）
    要做的事情

它由四个部分组成：关键字 def、一个函数名、一对圆括号 () 加冒号 :，以及下面缩进的函数体。是不是有点眼熟？它的"冒号 + 缩进"骨架和 if、while 一脉相承。

6.3.2 语法解剖（Anatomy）

6.3.2.1 一行行看清楚每个部件 Examine each part

以"乡村巡游者"里的函数为例，把"找敌人并攻击"这套逻辑完整地装进函数体：

# 这定义了 findAndAttackEnemy 函数
def findAndAttackEnemy():
    enemy = hero.findNearestEnemy()
    if enemy:
        hero.attack(enemy)

6.3.3 命名规则（Naming）

6.3.3.1 取个好名字，代码会"说话" Good names make code self-explaining

函数名可以自己起，但好名字能让代码自我解释。看本单元这些名字就知道它们各自负责什么：findAndAttackEnemy（找到并攻击）、findAndCleaveEnemy（找到并劈斩）、cleaveOrAttack（劈斩或攻击）、pickUpCoin（捡硬币）、checkAndAttack（检查并攻击）。

6.4.1 如何调用（How to Call）

6.4.1.1 写下名字加括号 Write the name with parentheses

定义好函数后，调用（call / invoke）它非常简单——写下函数名，后面跟一对圆括号即可。每写一次，函数体里的代码就完整执行一遍。

while True:
    hero.moveXY(35, 34)      # 走到第一个巡逻点
    findAndAttackEnemy()     # 调用！一行顶好几行

    hero.moveXY(60, 31)      # 走到右侧入口
    findAndAttackEnemy()     # 再调用一次，逻辑复用

6.4.2 定义 ≠ 调用（Define vs. Call）

6.4.2.1 写菜谱和照着做是两回事 Writing a recipe vs. cooking it

这是新手最容易绕晕的地方：定义函数和调用函数是两个完全不同的动作。 关卡反复强调："你需要编写函数的定义，这样你就可以在主循环中调用它了。"

6.4.3 调用时不要加 hero（No hero Prefix）

6.4.3.1 自己定义的函数，直接喊名字 Your own functions need no hero.

关卡特别强调了一个关键区别："调用函数时不要加 hero，因为函数由你定义，而不是英雄。"

hero.attack(enemy)        # attack 是英雄自带的 → 要加 hero.
findAndAttackEnemy()     # 这是你定义的 → 不加 hero，直接喊名字

这一节聚焦每一关如何用函数解决问题。看懂"为什么这样封装"，你就能自己写出完整解法。

6.5.1 乡村巡游者（Village Rover）

6.5.1.1 思路：把"找+打"封装成一个函数 Strategy: wrap find+attack into one function

图2：乡村巡游者——定义一个巡逻函数，在各入口反复调用

这是你第一次定义自己的函数。地图上有几个固定巡逻点，每个点都要做同样的"找敌人并攻击"。难点不在逻辑，而在于意识到"该把重复的部分抽出来"。策略就是把这套逻辑装进 findAndAttackEnemy()，然后在主循环里"移动 → 调用"地反复使用。

def findAndAttackEnemy():   # ① 先定义
    enemy = hero.findNearestEnemy()
    if enemy:
        hero.attack(enemy)

while True:                  # ② 再在循环里调用
    hero.moveXY(35, 34)
    findAndAttackEnemy()
    # 到右侧入口再调一次……

6.5.2 村庄守卫（Village Guard）

6.5.2.1 思路：定义多个函数，各司其职 Strategy: define multiple functions

图3：村庄守卫——同时定义"攻击"和"劈斩"两个函数，配合御敌

敌人成群来袭，单靠普通攻击不够了，需要再加一个使用 cleave 的函数。这一关教你同时定义并使用多个函数:findAndAttackEnemy 负责普通攻击,findAndCleaveEnemy 负责劈斩。后者里要做两层检查——敌人存在,且 cleave 就绪。

def findAndCleaveEnemy():
    enemy = hero.findNearestEnemy()
    if enemy:                       # 检查 1：敌人存在
        if hero.isReady('cleave'):  # 检查 2：劈斩就绪
            hero.cleave(enemy)

6.5.3 村庄守护神（Village Champion）

6.5.3.1 思路：在函数里融合嵌套 if/else Strategy: combine nesting inside a function

图4：村庄守护神——把上一单元的嵌套判断,整个封装进一个函数

这一关让你"只能靠自己"定义函数,而且要把第五单元学的嵌套 if/else 融进函数体。思路是写一个 cleaveOrAttack() 函数:有敌人时,如果 cleave 就绪就劈斩,否则就普通攻击——一个函数把"该用哪种攻击"的决策全部包办。

def cleaveOrAttack():
    enemy = hero.findNearestEnemy()
    if enemy:
        if hero.isReady('cleave'):
            hero.cleave(enemy)
        else:                       # 劈斩没好 → 普通攻击
            hero.attack(enemy)

6.5.4 造币厂（The Mint）

6.5.4.1 思路：照着示例，从零写一个函数 Strategy: write a function from scratch

图5：造币厂——既要捡硬币,又要在差役偷走前干掉它们

这一关要你"从头开始创建一个函数"。关卡给了 pickUpCoin(捡硬币)作示范,要你照葫芦画瓢,自己写一个 attackEnemy(攻击敌人)。pickUpCoin 里还用到了上一单元学的 pos:找到硬币后移动到它的 coin.pos.x, coin.pos.y 去捡。

def pickUpCoin():             # 关卡给的示例
    coin = hero.findNearestItem()
    if coin:
        hero.moveXY(coin.pos.x, coin.pos.y)

def attackEnemy():            # 照着写的新函数
    enemy = hero.findNearestEnemy()
    if enemy:
        hero.attack(enemy)

6.5.5 寂静市（概念挑战 · Silent City）

6.5.5.1 思路：把全部逻辑塞进一个函数 Strategy: put all logic in one function

这是一个概念挑战，要求很巧妙：必须定义一个函数，并且 while True 循环里只能有一条语句。 这等于强制你把"看到敌人就打、否则回中心"的全部逻辑都封装进一个函数，让主循环干净到只剩一行调用。

def checkAndAttack():
    enemy = hero.findNearestEnemy()
    if enemy:
        hero.attack(enemy)
    else:
        hero.moveXY(30, 26)   # 没敌人 → 回中心标记

while True:
    checkAndAttack()             # 循环里只有这一条语句！

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

6.6.1.1 定义和调用环节的典型问题 Typical issues when defining and calling

图6：定义了却忘记调用,是新手最常见的失误