深度拆解 Python 自定义函数:从入坑到避坑指南

大家好呀，我是小涵~

在咱们学 Python 的路上，同学们最怕的就是代码写得“又臭又长”。

同样的一段逻辑，到处复制粘贴，一旦要改，全城搜寻，漏改一个就是 Bug。这种“搬砖”式写代码，不仅累，还没前途。

今天，咱们就把 Python 的灵魂——自定义函数一次性聊透。不仅教你怎么写，更要教你怎么避开那些让小白抓狂的报错坑！

咱们把写代码想象成“开一家智能餐厅”。

如果你每接待一个客人都得现场教厨师怎么洗菜、切菜、炒菜……这叫“面向过程”，累死也开不了分店。

自定义函数，其实就是你厨房里的那台“智能烹饪机器人”。

你可以提前设定好它的工作逻辑（比如：定义如何做红烧肉）。

以后想吃红烧肉，只需要按一下按钮（调用函数），机器人就自动出锅了。

写函数不能信马由缰，Python 有一套严格的规矩。违反了，它可是会当场“罢工”的。

1.关键词与起手式

定义函数的命令必须以 def 开头，后面跟着函数名和括号。

def 函数名():

2.先定义，后调用（顺序不能乱）

Python 就像个性格古怪的管家，如果你不先告诉他这个招式怎么使，直接让他做，他会当场翻脸报错：

典型错误：NameError: name 'func1' is not defined

你要先在“食谱”上写好红烧肉怎么做，以后才能点这道菜。

3.同名函数：后来者居上

如果你在一个文件里定义了两个同名的函数，Python 会“喜新厌旧”，后定义的函数会直接覆盖掉前面的功能。

4.参数匹配：不多也不少

给函数传参时，必须做到“精准打击”。

多传了：报错 TypeError: ... takes 2 positional arguments but 3 were given（机器只有两个插槽，你非要插三个）。

漏传了：报错 TypeError: ... missing 1 required positional argument（材料没给全，机器转不动）。

5.返回值的“玄学”

有 return 的函数，结果可以用变量接住，就像果汁机流出了果汁，你拿个杯子接住。

没有 return 的函数，干完活不回话，你强行去接，只能接到一个 None（空）。

很多同学分不清这两者，其实只要一个比喻就秒懂：

形参 (Formal Parameter)：就像是机器人面板上的“插槽标签”（比如写着：水果、冰块）。它只是个占位符，没有实物。

实参 (Actual Parameter)：就是你手里那一袋“真的苹果”。当你把苹果塞进插槽时，实参就赋值给了形参。

def make_juice(fruit):  # fruit 是形参（占位符）                 return f"一杯新鲜的{fruit}汁" # 调用时 print(make_juice("苹果")) # "苹果" 是实参（真实数据）

1.无参、无返回值：指令器

它不接收信息，也不反馈结果，只是执行一套固定动作。

比喻：礼宾机器人，只会说“欢迎光临”。

def say_hi():    print("你好，AI全栈工程师！") say_hi()

2.有参、无返回值：传声筒

你给它材料，它处理完就结束，不吐回结果。

比喻：垃圾处理机。你给它垃圾（参数），它负责处理掉。

def greet(name):    print(f"欢迎来到实战课，{name}！") greet("老王")

3.无参、有返回值：传感器

它不需要你提供原材料，但会根据内部状态吐出一个结果给你。

比喻：温度计。你看它一眼，它就告诉你现在的温度。

def get_status():return "系统运行正常" msg = get_status()print(msg)

4.有参、有返回值：多功能处理机 (最常用)

这是最常用、最强大的形态。你给它原料，它还你成品。

比喻：面包机。投入面粉（参数），还你面包（返回值）。

def add(num1, num2):return num1 + num2 # 必须精准传递两个参数 res = add(10, 20) print(res)