Python零基础入门:函数基础与代码模块化

一、为什么需要函数？

上节课我们学习了如何用 strip() 和 lower() 完美净化玩家的疯狂输入测试。

但在我们不断添加新功能（例如新增道具、场景）的过程中，有些代码被反复复制粘贴，这在编程中被称为“代码异味（Code Smell）”。如果未来我们需要修改这部分逻辑，就不得不在几十个地方挨个修改，太折磨了。通过“函数”，我们可以把重复的代码封装起来，不仅减少了代码量，还方便统一管理和重复利用！

二、函数的定义与调用

就像我们在数学课上学的方程，输入原料，产出结果。在 Python 中，def (Define) 关键字是函数的起点，告诉程序我们要定义一个新工具。

1. 组装工具：定义函数

首先给你的工具起个名字，然后缩进写下这个工具具体要干什么。

def print_welcome():    print("====== 欢迎来到冒险大陆 ======")    print("准备好了吗？冒险即将开始！")    print("==============================")

2. 使用工具：调用函数

定义好的函数并不会自己运行，需要我们在需要的地方去调用（Call）它。这就好比只要喊出工具的名字并加上括号，程序就会把里面的代码执行一遍。

# 调用函数，只要一行代码！print_welcome()

三、更智能的函数：参数与返回值

如果我们的函数只能干固定死板的事情肯定是不够的。下面让我们的代码真正“动”起来！

1. 给机器加料：函数参数

我们可以给函数留下一些“参数”（就像是机器的进料口），让函数根据传入的不同数据，执行个性化的任务。这叫传递实参（Arguments）。

def attack_monster(monster_name):    # 这里的 monster_name 就是个变量占坑符，留着等外部喂给它数据。    print(f"你挥舞着武器，向 {monster_name} 发起了猛烈的攻击！")# 外围调用时，我们喂给它真正的名字数据attack_monster("史莱姆")attack_monster("哥布林")

2. 拿到结果报告：函数的返回值

函数不仅能接收数据执行打印，还能经过计算后向外界“返回”结果。我们需要用到 return 关键字。

def calculate_damage(base_attack, weapon_bonus):    total = base_attack + weapon_bonus    # 把 total 送出去，给调用的人！    return total# 必须拿一个变量把函数抛出来的值给“接住”final_damage = calculate_damage(10, 5)print(f"你造成了 {final_damage} 点伤害！")

⚠️ 提示：一旦函数执行到 return，它就会立即结束执行并退出该函数，后面的代码哪怕写了也不会理会！

四、阶段小项目：打造专属的【装备锻造台】

纸上得来终觉浅，绝知此事要躬行！现在，请你运用本节课学到的无参函数、带参函数及返回值，独立完成下面这个小型拓展项目：

🎯 项目需求

• 启动程序后，调用一个自己写的 welcome() 函数，专门用于打印【神奇铁匠铺】的花式欢迎语。
• 主程序要求玩家分别输入武器名称（如 "木棍"）和强化材料（如 "附魔碎片"）。
• 将信息传递给一个名为 forge_weapon(weapon, material) 的带参函数。
• 该函数内部不仅要打印类似“正在猛烈敲击...”的进度提示，还需要拼装好全新的武器名称，并通过 return 返回给主程序。
• 最后由主程序接收该返回值，并激动地宣布打造成功及新武器名字！

💡 参考代码框架

# 【1】定义欢迎函数def welcome():    print("===============================")    print("  🔥 欢迎来到神奇铁匠铺 🔥  ")    print("===============================")# 【2】定义打造函数（需参数并返回结果）def forge_weapon(weapon, material):    print(f"铁匠正在将 {material} 熔炼入 {weapon} 中...")    print("哐！哐！哐！")    # 拼装出新名字    result_name = f"【{material}强化的{weapon}】"    # 交还给主系统    return result_name# ================================# 主程序运行区# ================================welcome()w = input("请输入你的基础武器：").strip()m = input("请投入你的强化材料：").strip()# 调用功能，并拿一个变量接住它 return 吐出来的东西final_weapon = forge_weapon(w, m)print(f"\n✨ 太棒了！打造成功！你获得了专属武器：{final_weapon}！")

五、核心项目：代码模块化整理 v5.0

现在，我们要改造上节课的主循环架构。将“打印玩家状态”和“随机掉落道具”这两大模块抽取成函数。你会发现，一旦代码封装完成，主游戏循环 while True 会变得如同说明书一般清晰。

import randomplayer_hp = 100player_attack = 5locations = ("山谷", "森林", "山顶", "洞穴")backpack = set()item_db = {    "potion": {"desc": "小型恢复药水", "type": "heal", "value": 30},    "axe": {"desc": "木斧", "type": "attack", "value": 10},    "hammer": {"desc": "铁锤", "type": "attack", "value": 15},    "shield": {"desc": "木盾", "type": "defense", "value": 1}}# ================================# 函数核心区域：把重复功能打包放这# ================================def show_status():    """这是打印玩家当前各维状态的专属函数"""    print(f"【勇者状态】 生命: {player_hp} | 攻击: {player_attack} | 背包数量: {len(backpack)}")def drop_item(current_loc):    """这是专门负责随机发装备的后勤大队长"""    drops = ["potion", "axe", "hammer", "shield"]    got_item = random.choice(drops)    if got_item in backpack:        print(f"探索了 {current_loc}，但 {got_item} 已存在，丢弃。")    else:        backpack.add(got_item)        print(f"你探索了 {current_loc}，获得新道具：{got_item}")# ================================# 游戏主循环区# ================================while True:    print("====== 冒险菜单 v5.0 ======")    print("1. 外出探索")    print("2. 查看背包")    print("3. 使用道具")    print("4. 查看状态")    print("5. 退出游戏")    print("===========================")    choice = input("请输入选择：").strip()    if choice == "1":        current_loc = random.choice(locations)        # 【修改点1】：调用我们写好的掉落函数！直接把当前地点当参数喂进去。        drop_item(current_loc)    elif choice == "2":        if len(backpack) == 0:            print("背包是空的")        else:            print("【当前背包】")            for item_name in backpack:                info = item_db.get(item_name, {"desc": "未知道具"})                print(f"- {item_name}：{info['desc']}")    elif choice == "3":        if len(backpack) == 0:            print("背包是空的，先去探索吧！\n")            continue        target = input("请输入要使用的道具名英文：").strip().lower()        if target not in backpack:            print("错误：你的背包里没有这个道具，请检查拼写。")        else:            info = item_db.get(target)            if info is None:                print("这个道具没有配置功能")            else:                item_type = info["type"]                item_value = info["value"]                if item_type == "heal":                    player_hp += item_value                    print(f"使用 {target}，恢复 {item_value} 点生命！")                    backpack.remove(target)                elif item_type == "attack":                    player_attack += item_value                    print(f"装备了 {target}，攻击力增至 {player_attack}！")                    backpack.remove(target)                elif item_type == "defense":                    print(f"举起了 {target}，准备好防御下一次攻击！")                    backpack.remove(target)    elif choice == "4":        # 【修改点2】：一行调用，不用再这里写那长长一大串的排版日志了！        show_status()    elif choice == "5":        print("游戏结束，欢迎下次再来。")        break    else:        print("输入不合法，请重新输入 1-5 之间的数字！")    print()

💡 避坑指南：函数内部访问全局变量的底层逻辑

在把代码收纳进函数时，许多初学者会遇到疑惑：“为什么 show_status() 和 drop_item() 里面可以直接引用 player_hp 或 backpack，而在修改生命值（例如 player_hp += 30）时，却报错或者非要加 global 呢？”

这是 Python 里非常经典的全局变量作用域规则：

1. 只读访问：
   如果函数内部仅仅是读取全局变量的值来展示（如 print(player_hp)），Python 允许直接调用，不需要任何声明。
2. 就地修改容器（Mutable）：
   如果全局变量是可变容器（如 backpack 集合），我们在函数内使用 backpack.add() 或 backpack.remove()，这属于“就地修改内部元素”，变量本身的内存指向并没有改变，因此也不需要声明 global。
3. 重新赋值（Immutable / 重大覆写）：
   如果你试图直接修改不可变类型（如数字、字符串），写了 player_hp += 30（本质是 player_hp = player_hp + 30）。因为这里出现了等号重新赋值操作，Python 默认会认为你在函数内定义一个局部变量，从而导致检索不到而报错（UnboundLocalError）。

修复绝招：只要你想在函数内部直接修改不可变全局变量的值，就必须在函数首行写上：global player_hp, player_attack，提前申请“跨区域修改通行证”。

⚠️ 重构代码时的 continue ➡️ return 蜕变

当我们把主循环代码（例如菜单 3 使用道具的代码）剪切装进独立的 use_item() 函数时，原有的 continue 会引发语法错误，因为continue 和 break 只能在循环体里跳跃，无法在普通函数中直接使用！

完美解决方案：在函数内部，直接用 return 替换 continue。return 不仅能返回结果，还承担着“立刻终止执行，弹出本函数”的重任务，简直就是函数的“紧急出口”！

六、重点整理

• def 声明：
  就像图纸，定义函数名并编写处理逻辑。
• 参数：
  让函数具备“通配”能力，处理外部灌入进来的各异数据。
• 返回值：
  通过 return 将函数内部的结果产出反哺给系统。
• 主轴重构：
  主循环逻辑大幅瘦身，将繁琐的底层代码封存在函数体中，只在一遍遍的调用中产生业务！