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。 把内容写入输出。

如果一个函数同时询问输入、计算、写文件和打印,复用其中一部分就会困难。可按清楚的职责拆分,让计算接收值并返回值,让外层处理交互与存储。函数名和文档字符串应说明真实的结果、前提与异常,而不是承诺尚未实现的检查。

检查缺失返回值与调用错误

  1. 把第一次调用的费用从 500改成 1000,第一项应变为 9000,总和应变为 12500。
  2. 把函数中的 return amount + fee暂时改成 print(amount + fee)。函数先分别打印 8500 和 3500,但 first 与 second 都是 None;打印它们会看到 None None,继续相加则产生 TypeError。
  3. 把函数调用放在本文件的 def 语句之前执行,在没有已有同名绑定的情况下会产生 NameError。不是只要文件后面写了定义,前面就能先调用。
  4. 恢复原始定义、调用顺序与费用 500,再核对完整输出。

缺少必需实参,例如只调用 total_with_fee(8000),会得到 TypeError。检查调用提供的项数是否与定义一致,不要为消除错误而随意填写没有业务含义的默认值。

函数内部创建的局部名称通常不能直接从函数外读取。需要让调用者获得结果时,应显式返回,而不是依赖隐藏的全局修改。每条执行路径是否都有预期返回值,也应像条件分支中的变量赋值一样逐项检查。