Python函数定义与调用的基础语法指南

一、函数定义的基础语法结构

定义函数是指在程序中声明一个具名代码块，规定该代码块接收哪些参数以及执行何种运算。Python 使用 def 关键字开启函数的定义流程，基本语法模板如下：

def 函数名(形参1, 形参2, ...):
    """文档字符串（Docstring，用于描述函数功能与参数规约）"""
    # 函数体代码块（必须保持严格缩进）
    return 返回值

一个标准的 Python 函数由以下六个语法要素构成：

• def 关键字：Python 保留关键字，用于向解释器声明“正在创建一个函数对象”。该关键字后必须保留至少一个空格。
• 函数标识符命名：遵循 Python 标识符命名规范。建议采用小写字母加下划线的蛇形命名法（snake_case），例如 calculate_total。不能以数字开头，且不可与 Python 内置关键字重名。
• 形参列表（Parameters）：位于函数名后的一对圆括号内，用于指定函数期望接收的变量。即便函数不需要任何输入，圆括号也必须保留。
• 末尾冒号（:）：函数头末尾的冒号是 Python 语法强制要求的符号，用于标志头部声明结束、代码块作用域开启。
• 缩进函数体：冒号下一行开始的代码构成函数体，必须保持统一缩进（PEP 8 规范推荐使用 4 个空格）。函数体内的变量属于该函数的局部命名空间。
• return 语句：用于向外部调用方交回数据并终止函数执行。如果函数体内没有显式书写 return，函数执行完毕后会自动返回 None。

在编写工程代码时，建议在函数体首行添加文档字符串（Docstring）。文档字符串采用三引号括起，可以通过内置函数 help(函数名) 或访问 函数名.__doc__ 属性直接调阅，便于团队协作与代码维护。

二、函数的调用过程与执行生命周期

函数定义完成后，并不会自动执行其内部的代码块，只有在程序中被显式“调用”时，解释器才会跳转并执行函数体。调用函数的基础语法为：在函数名称后紧跟一对圆括号，并在括号内按需传入具体的“实际参数”（Arguments，简称实参）。

# 1. 定义函数
def calculate_price(unit_price, discount=0.1):
    """计算商品折后总价"""
    final_price = unit_price * (1 - discount)
    return final_price

# 2. 调用函数并将结果赋给变量
order_total = calculate_price(100, 0.2)
print("实付金额为:", order_total)

当执行到 calculate_price(100, 0.2) 语句时，Python 解释器在底层经历五个标准生命周期阶段：

1. 调用发起与实参求值：解释器在主作用域解析实参表达式 100 和 0.2，确认函数对象存在，并暂停当前执行流。
2. 压栈与局部栈帧分配：解释器在调用栈（Call Stack）上为该函数分配一个独立的栈帧（Stack Frame），建立局部作用域（Local Scope），并将实参值绑定到形参变量上。
3. 函数体逐行执行：控制流进入函数内部，按照代码顺序依次计算局部变量 final_price。在此期间，函数内部对局部变量的读写均被隔离在该栈帧内。
4. return 触发与栈帧销毁：遇到 return final_price，解释器将计算出的结果对象提取出来，随即弹出并销毁该栈帧，释放局部变量。
5. 恢复主执行流：控制权交还给调用行，返回值赋给外层变量 order_total，程序继续执行后续逻辑。

三、参数传递机制：位置参数、关键字参数与默认参数

在 Python 中，实参与形参之间的映射方式非常灵活，常用的基础传递方式包括位置参数、关键字参数以及默认参数三种。

1. 位置参数（Positional Arguments）

位置参数是基础的传参方式。调用时传入实参的物理先后顺序，与函数定义时形参的排列顺序严格保持一致。第一个实参赋值给第一个形参，第二个实参赋值给第二个形参。位置参数要求实参数量与形参数量完全一致，多传或少传均会报错。

2. 关键字参数（Keyword Arguments）

关键字参数允许在调用函数时以 形参名=实参值 的形式明确指明目标形参。这种方式打破了物理位置的次序限制，可以任意调整传参顺序，极大增强了函数调用时的自解释性与可读性。

def format_user_card(username, role, status):
    return f"用户: {username} | 角色: {role} | 状态: {status}"

# 关键字参数调用（顺序颠倒依然能正确匹配）
card = format_user_card(role="管理员", status="在线", username="Alice")
print(card)

3. 默认参数（Default Arguments）

在定义函数时，可以直接为某个形参预设一个缺省默认值（例如 def connect(host, port=3306)）。在调用该函数时，如果提供了对应的实参，则覆盖默认值；如果未提供，则自动采用预设值。

在实际编码中，需要严格遵守 Python 参数传递的两大语法规约：

• 定义时规约：带默认值的形参必须全部位于无默认值形参的后方。例如 def fn(a, b=10): 合法，而 def fn(a=10, b): 会直接触发 SyntaxError: non-default argument follows default argument。
• 调用时规约：位置实参必须位于所有关键字实参的前方。例如 fn(1, b=2) 合法，而 fn(a=1, 2) 会触发 SyntaxError: positional argument follows keyword argument。

# 错误写法（会造成跨调用数据污染）：
# def append_item(val, container=[]):

# 正确规范写法：
def append_item(val, container=None):
    if container is None:
        container = []
    container.append(val)
    return container

四、函数的返回值处理机制

return 语句承担着向外界输出计算结果和终结函数执行的双重职责。根据不同的业务场景，返回值有以下几种典型用法：

1. 省略 return 或直接书写 return（返回 None）

当函数仅用于执行动作（如打印信息、写入日志、更新数据库等副作用操作）而不需要向外部输出运算结果时，可以省略 return 语句，或者仅书写空的 return。此时调用该函数的表达式求值结果统一为 Python 单例对象 None。

def log_message(msg):
    print(f"[LOG] {msg}")

res = log_message("系统就绪")
print("调用结果:", res)

2. 返回单个数据对象

这是常见的返回模式。表达式计算后的数值、字符串、列表或自定义对象直接通过 return 抛出，调用方可以使用变量承接该值，或直接参与到其他运算表达式中。

3. 返回多个值（元组解包语法）

Python 允许在一个 return 语句后放置多个用逗号隔开的变量。在底层，解释器会自动将这些值打包为一个不可变的元组（Tuple）。调用方既可以将其作为单个元组接收，也可以利用元组解包语法直接解构赋给多个独立变量。

def get_server_status():
    code = 200
    msg = "OK"
    latency = 12.5
    return code, msg, latency  # 实质返回 (code, msg, latency)

# 使用多变量同时解包接收
status_code, status_msg, rtt = get_server_status()
print(f"状态码: {status_code}, 信息: {status_msg}, 延迟: {rtt}ms")

4. 利用 return 实现防御性提前退出（Guard Clause）

一旦遇到 return 语句，函数体内的后续代码无论有多少行均会立即停止执行并跳出。在日常编码中，可以利用此特性在函数开头做参数校验，不符合预期时立即返回，避免多层嵌套的 if-else 结构。

五、初学者高频语法报错与自查排查指南

在编写与调用 Python 函数的过程中，初学者常会因为拼写、标点或顺序失误而触发语法报错。下表整理了高频出现的异常类型与排查方案：

综上所述，Python 函数的定义与调用以简洁清晰著称。在日常编写时，牢记定义用 def、调用加 ()、返回看 return、默认参数置于末尾、可变对象切勿作为默认值等原则，就能在构建模块化代码时规避绝大部分语法陷阱。