函数 · 让代码长成模块

第15章 魔法盒子

函数入门

第 15 章 魔法盒子:函数入门

📖 本章目标:学会定义和调用函数,理解参数、返回值、作用域基础。
学完本章,你的代码终于能"化整为零"——把大问题拆成一个个小盒子。
函数是 Python 最重要的"组织代码"工具。前面你写的所有程序都是"一条直线",从本章开始,代码会变成"一栋房子"——由一块块积木拼起来。这是从"会写代码"到"会组织代码"的转折点。


【开场小剧场】咖啡机哲学

学生: 皮皮,我写的猜数字越来越长,代码堆在一起好乱,怎么办?

皮皮: 该学函数了。你想,咖啡机是不是一个盒子——你往里投咖啡豆和水(输入),按一下按钮,它"啪"地吐出一杯咖啡(输出)?

学生: 所以函数就是咖啡机?

皮皮: 对!函数就是代码界的咖啡机:把一段代码装进盒子,起个名字,以后想用就喊它的名字,不用重新写一遍。今天,我们就来造第一台咖啡机。

学生: 那咖啡机可以重复用吗?

皮皮: 这正是函数的精髓——造一次,用一辈子。你写了 greet(),想打招呼就喊一声,喊一万次它都乐意,而且不会喊累。


15.1 定义函数:造一台咖啡机

用 def 定义函数,语法:

def 函数名(参数):
    函数体
    return 返回值

看一个最简单的"打招呼咖啡机":

def greet():
    print("你好呀,我是皮皮!")
    print("欢迎来到 Python 的世界!")

逐行拆解:
- def greet()::def 定义,greet 是咖啡机名字,结尾冒号别忘了;
- 下面两行 print(...):函数体,必须缩进(和 if/while 一个规矩);
- 这个函数没有参数(括号是空的),也没有 return——它只是"干点事",不吐结果。

定义之后,不会自动执行——就像咖啡机摆在店里,你不按按钮它不会自己出咖啡。要调用它:

greet()      # 喊一声名字,函数体就执行一遍
greet()      # 想喝两杯?再调一次

运行结果:

你好呀,我是皮皮!
欢迎来到 Python 的世界!
你好呀,我是皮皮!
欢迎来到 Python 的世界!

好处立现:如果这个打招呼要 10 行,你写函数一次,以后每次调用只写一行 greet()。

函数是怎么"记住"这段代码的? 类比咖啡机:机器里存着"做咖啡的配方",你按按钮,配方就执行一遍。函数的"配方"就是函数体,按按钮就是调用。

🐍"皮皮注:def 是 define(定义)的缩写。注意定义函数时函数体要缩进,和 if / while 一个道理。忘了缩进,函数就'散架'了。"

配套代码文件:code/ch15/greet.py。


15.2 参数:投料口

咖啡机不能只做一种咖啡吧?参数就是函数外面的"投料口",让你每次调用时传入不同的东西:

def greet(name):
    print("你好呀,", name, "!")

greet("皮皮")      # 你好呀, 皮皮 !
greet("小美")      # 你好呀, 小美 !

这里:

逐行拆解:
- def greet(name):函数声明一个投料口,叫 name;
- 函数体里 name 就是一个普通变量,表示"这次投进来的材料";
- greet("皮皮"):调用时把 "皮皮" 投进去,函数里 name = "皮皮";
- greet("小美"):再调用,name = "小美"。

每次调用 greet("小美"),函数里的 name 就变成 "小美"——同一个函数,投不同材料,出不同结果。

多个参数就多加几个投料口:

def greet(name, age):
    print(f"{name}今年{age}岁")

greet("皮皮", 30)      # 皮皮今年30岁
greet("小美", 28)      # 小美今年28岁

💡 调用的顺序要和定义一致:第一个实参给第一个形参,第二个实参给第二个形参。greet(30, "皮皮") 就会闹笑话——把 30 当名字输出。

换例加深:用参数让代码活起来

def make_box(char, width):
    print(char * width)

make_box("*", 5)      # *****
make_box("#", 8)      # ########

同一个函数,传不同参数,画出不同的盒子——这就是参数的威力:它把"变的部分"从代码里抽出来,交给你每次调用时决定。

配套代码文件:code/ch15/greet.py。


15.3 返回值:吐出来的咖啡

函数除了"干点事",还可以"给你个结果"——这叫返回值,用 return:

def add(a, b):
    result = a + b
    return result        # 把结果交出来

total = add(3, 5)        # total 接住返回值
print(total)             # 8

逐行拆解:
- result = a + b:函数里算出结果;
- return result:把结果"递出"咖啡机;
- total = add(3, 5):调用处接住这个返回值,存进 total;
- print(total):total = 8。

关键: return 后面的值会"回到"调用处,你可以把它存进变量、打印、参与运算。

换例加深:返回值直接参与运算

def double(x):
    return x * 2

print(double(5) + double(10))    # 10 + 20 = 30

没有 return 的函数,返回的是 None:

def add(a, b):
    a + b                # 忘了 return!

total = add(3, 5)
print(total)             # None

None 是"什么都没有"的意思。你忘了 return,函数就偷偷把结果吞了,什么都不给你。 这是新手最容易犯的错误。

再写一个实用点的:判断一个数是不是素数(只能被 1 和它自己整除):

def is_prime(n):
    if n < 2:
        return False
    for i in range(2, n):
        if n % i == 0:
            return False
    return True

print(is_prime(7))      # True
print(is_prime(8))      # False

逐行拆解:
- if n < 2: return False:小于 2 的数不是素数,直接退;
- for i in range(2, n):从 2 试到 n-1;
- if n % i == 0: return False:一旦能被某个 i 整除,不是素数,立刻走人;
- 循环跑完都没被整除,return True:是素数。

注意 return 的另一个作用:立刻结束函数。 上面一旦发现 n % i == 0,就 return False 直接走人,后面的代码不执行了。

🐍"皮皮注:return 是两个身份:一是'交出结果',二是'立即下班'。很多函数会写多个 return,每个负责一个'提前退场'的场景——这叫'早退',是合法的,还很受欢迎。"

配套代码文件:code/ch15/is_prime.py。


15.4 docstring:给咖啡机贴说明书

写函数时,顺手写一段文档字符串(docstring),用三引号放在函数开头,说明"这台机器是干嘛的":

def add(a, b):
    """返回 a 加 b 的和。"""
    return a + b

好处:别人(或几天后的你)调用时,能看到这段说明。有的编辑器还会在你调用时把它弹出来当提示。

还能用 help(函数名) 看到它:

help(add)

会输出:

Help on function add in module __main__:

add(a, b)
    返回 a 加 b 的和。

💡 写 docstring 是专业习惯。一句话就够:"""把两数相加并返回结果。""" 比什么注释都管用。注释写"为什么",docstring 写"干什么"。

换例加深:复杂函数的 docstring 可以写多行

def get_grade(score):
    """根据分数返回等级。

    规则:>=90 优秀,>=80 良好,>=60 及格,否则不及格。
    """
    if score >= 90:
        return "优秀"
    elif score >= 80:
        return "良好"
    elif score >= 60:
        return "及格"
    else:
        return "不及格"

【皮皮小课堂】本章要点


【翻车现场】本章的坑

坑 1:忘了 return

def add(a, b):
    a + b          # ❌ 只算不还
print(add(3, 5))   # None

函数体内计算的结果,不会自动跑出来。 想要结果,必须 return。写完函数问自己一句:"我该不该把结果交出去?"

坑 2:函数体内缩进错误

def greet():
print("你好")     # ❌ 没缩进,不是函数体!

报错 IndentationError。函数体内必须缩进,和 if/while 一个规矩。

坑 3:调用时少传参数

def greet(name, age):
    print(name, age)
greet("皮皮")     # ❌ 少了一个实参,报错 TypeError

参数数量要对上。少了,TypeError: greet() missing 1 required positional argument: 'age'。多了同理。报错信息会点名缺哪个参数,照着补就行。

坑 4:函数名写成内置函数名

def print():
    ...

print 不是关键字,但别用内置函数名当自己的函数名——那会把原本的 print 覆盖掉,引起一堆麻烦。同理别叫 len、sum、type。取名要避开这些"名人",免得抢了人家的饭碗。

坑 5:调用函数忘了加括号

def greet():
    print("你好")

greet        # ❌ 没括号!这不是调用,只是"看了一眼函数的地址"
greet()      # ✅ 有括号才是调用

greet(不带括号)指代"函数本身",greet()(带括号)才是"执行它"。写 print(greet) 会输出一串函数地址,而不是执行。记:函数要跑,必带括号。

坑 6:return 和 print 分不清

def add(a, b):
    print(a + b)     # 只是"打印",没 return

result = add(3, 5)   # 屏幕上会打印 8
print(result)        # 但 result 是 None!

print 是"展示给人看",return 是"把结果交回代码"。想让调用处能用结果,必须 return;只想看看,才用 print。 两者是两种完全不同的"出口"。


【本章习题】

一、选择题

1. (★) 定义函数用什么关键字?

2. (★★) 运行下面代码,输出结果是?

def fun():
    print("A")

print(fun())

3. (★★) 下面代码的输出是?

def square(x):
    return x * x

print(square(square(2)))

4. (★★ 多选) 关于函数,下列说法正确的是?

5. (★★ 多选) 关于 return 和 print,下列说法正确的是?

二、判断题

1. (★) def greet(): 后面必须有冒号,函数体必须缩进。( )

2. (★★) 函数可以调用另一个函数。( )

3. (★★) return 一旦执行,函数就立刻结束,后面的代码不再运行。( )

4. (★★) def fun(): pass 是一个合法的空函数定义。( )

三、代码纠错题

1. (★★) 下面的代码输出 None,请指出问题并改正:

def add(a, b):
    total = a + b

print(add(3, 4))

2. (★★) 下面的代码调用时报错,请指出原因并改正:

def greet(name, age):
    print(f"{name}今年{age}岁")

greet("皮皮")

四、编程实战题

1. (基础 ★) 写一个函数 say_hello(n),调用时传入一个名字,输出 "你好, {名字}!"。分别调用两次,传两个不同的名字。

2. (基础 ★★) 写一个函数 find_max(a, b, c),返回三个数中最大的那个(不允许用 max 函数,自己用 if 判断)。

3. (基础 ★★) 写一个函数 calc(a, b, op),接收两个数和运算符字符串("+" "-" "*" "/"),返回运算结果(除法注意除零时返回 "除数不能为0")。

4. (挑战 ★★★) 写一个函数 describe_triangle(a, b, c),接收三条边,判断它们能否构成三角形(两边之和大于第三边),能则返回 "能",不能则返回 "不能",并说明理由(返回一句话)。提示:三角形的判定是"任意两边之和大于第三边"。



【参考答案与解析】

一、选择题

1. 答案:B
Python 用 def 定义函数(define 的缩写)。

2. 答案:B
fun() 内部 print("A") 先输出 A;fun() 没有 return,返回 None,外层 print(None) 再输出 None。所以两行:A 和 None。

3. 答案:C
先算里面的 square(2) = 4,再算 square(4) = 16。函数嵌套调用时,先内后外。

4. 答案:A、B、C
A 对:定义不执行,调用才执行;B 对:return 返回值;C 对:忘 return 返回 None;D 错:函数可以有多个参数。

5. 答案:A、B、C
A 对:return 交回代码,print 展示给人;B 对:可以有多个 return(提前退场);C 对:return 立刻结束函数;D 错:print 只是打印,调用处拿到的是 None,不是打印的那个值。

二、判断题

1. 正确(√)。def 行末有冒号,函数体缩进,这是语法规则。

2. 正确(√)。函数里可以调用其他函数(包括前面定义的)。

3. 正确(√)。return 立即结束函数,后面代码不执行。

4. 正确(√)。pass 是"什么都不做"的占位符,def fun(): pass 是一个合法的空函数,常用于先搭好骨架再填内容。

三、代码纠错题

1. 解析: add 里算了 total 但没 return,所以调用返回 None。改正:

def add(a, b):
    total = a + b
    return total

print(add(3, 4))    # 7

2. 解析: 定义需要两个参数 (name, age),调用时只传了一个,报 TypeError: greet() missing 1 required positional argument: 'age'。要么补上第二个实参:

greet("皮皮", 30)   # 皮皮今年30岁

要么给 age 一个默认值(下一章会正式学):

def greet(name, age=0):
    print(f"{name}今年{age}岁")

greet("皮皮")       # 皮皮今年0岁

四、编程实战题

1. 参考代码:

def say_hello(name):
    print(f"你好, {name}!")

say_hello("皮皮")
say_hello("小美")

2. 参考代码:

def find_max(a, b, c):
    if a > b and a > c:
        return a
    elif b > a and b > c:
        return b
    else:
        return c

print(find_max(3, 9, 5))     # 9
print(find_max(-1, -5, -3))  # -1

3. 参考代码:

def calc(a, b, op):
    if op == "+":
        return a + b
    elif op == "-":
        return a - b
    elif op == "*":
        return a * b
    elif op == "/":
        if b == 0:
            return "除数不能为0"
        return a / b
    else:
        return "不支持的运算符"

print(calc(10, 5, "+"))   # 15
print(calc(10, 0, "/"))   # 除数不能为0

4. 参考代码:

def describe_triangle(a, b, c):
    if a + b > c and a + c > b and b + c > a:
        return f"{a}, {b}, {c} 能构成三角形"
    else:
        return f"{a}, {b}, {c} 不能构成三角形"

print(describe_triangle(3, 4, 5))     # 能
print(describe_triangle(1, 2, 3))     # 不能(1+2=3,不大于3)

🐍"皮皮注:函数是代码世界的积木。第 22 章的学生管理系统,你会看到怎么用一堆小函数拼出一个大程序——那才是函数真正发光的时候。"


📖 下一章,参数进阶:默认参数、关键字参数,还有那个神秘的 *args。

📦 本章配套代码

运行方式:命令行进入目录后执行 py 文件名.py(Windows)或 python3 文件名.py(Mac/Linux)