Python 教程 / 定义函数、传递参数与返回结果
函数为一个处理步骤命名,通过形参接收输入,并用 return向调用者返回结果。返回数值与打印数值是不同的动作;将计算和显示分开,才能方便地在其他计算、测试或界面中复用同一逻辑。
理解形参、实参与返回值
def后面写函数名称、括号中的形参和冒号,再用缩进定义函数体。形参是定义中的输入名称;实参是调用时实际传入的值。定义执行后会创建函数,但不会立刻运行函数体;调用时才执行其中的处理。
return value结束当前函数调用,把 value 交给调用者。没有 return,或只写没有值的 return,都会返回 None。如果只在函数中 print,屏幕虽然显示了内容,调用者却不会因此自动得到那个数值。
具体规则见Python 官方函数定义说明。计算函数返回结果,由调用代码决定是否打印,是一个便于重用和验证的组织方式。
运行完整的计算函数
在独立练习目录,把下面完整内容保存为 UTF-8 的 functions.py。在项目环境执行 python functions.py;macOS、Ubuntu 若使用 python3,按已核对的解释器运行。无需安装第三方包。
def total_with_fee(amount, fee):
"""Return the sum of the amount and fee."""
return amount + fee
first = total_with_fee(8000, 500)
second = total_with_fee(3500, 0)
print(first, second)
print(first + second)
预期输出:
8500 3500
12000
第一次调用传入金额 8000、费用 500,返回 8500;第二次传入 3500 和 0,返回 3500。变量 first 和 second 保存返回值,所以最后还能继续相加得到 12000,而不必重新读取屏幕上的文字。
函数体开头的三引号字符串是文档字符串,英文内容意为“返回金额与费用的合计”。它可用于说明用途,而不是给程序增加额外的数值验证。变量、形参和赋值基础见变量与输入输出。
明确函数职责和输入约定
这个函数只执行相加,例子约定输入是能相加的数值。它没有限制负数、整数单位或最大金额,也不会自动做汇率换算。业务需要这些限制时,应在合适的数据边界验证,并清楚说明内部函数接受什么。
Python 的加号也可以连接两个字符串,因此把两个文本传入时可能得到连接结果,而不是报错。不能把“函数运行成功”当作数值类型已经通过验证。文本到整数的处理应按明确规则进行,不能仅靠函数名称 total 来推断程序已经检查。
| 语句 | 调用者得到什么 | 显示行为 |
|---|---|---|
| return total | 返回 total 的值。 | 本身不打印。 |
| print(total) | print 调用返回 None。 | 把内容写入输出。 |
如果一个函数同时询问输入、计算、写文件和打印,复用其中一部分就会困难。可按清楚的职责拆分,让计算接收值并返回值,让外层处理交互与存储。函数名和文档字符串应说明真实的结果、前提与异常,而不是承诺尚未实现的检查。
检查缺失返回值与调用错误
- 把第一次调用的费用从
500改成1000,第一项应变为9000,总和应变为12500。 - 把函数中的
return amount + fee暂时改成print(amount + fee)。函数先分别打印 8500 和 3500,但 first 与 second 都是 None;打印它们会看到None None,继续相加则产生 TypeError。 - 把函数调用放在本文件的 def 语句之前执行,在没有已有同名绑定的情况下会产生 NameError。不是只要文件后面写了定义,前面就能先调用。
- 恢复原始定义、调用顺序与费用 500,再核对完整输出。
缺少必需实参,例如只调用 total_with_fee(8000),会得到 TypeError。检查调用提供的项数是否与定义一致,不要为消除错误而随意填写没有业务含义的默认值。
函数内部创建的局部名称通常不能直接从函数外读取。需要让调用者获得结果时,应显式返回,而不是依赖隐藏的全局修改。每条执行路径是否都有预期返回值,也应像条件分支中的变量赋值一样逐项检查。




