Python函数定义基础：def语法结构与调用规范

在 Python 编程中，函数是将一组特定逻辑打包并赋予名称的基本机制。掌握函数的定义与调用，能够将复杂的系统拆解为职责明确、便于调试与复用的模块。本文针对初学者在编写函数时经常遇到的结构疑惑与传参陷阱，直接剖析 def 核心语法细节、参数设计准则以及严格的调用规范，帮助读者建立标准、严谨的代码编写习惯。

一、def 关键字与基本结构剖析

在 Python 中，定义一个函数必须使用 def（define 的缩写）关键字。一个合规的基础函数结构由六个部分组成：def 声明、函数标识符、形式参数列表、行尾冒号、缩进的函数体以及可选的返回值语句。

下面是一个标准的实际函数示例。它展示了如何计算商品的总价，并包含规范的文档注释（docstring）：

# 环境要求：Python 3.8+
def calculate_total(price, tax_rate=0.05):
    """
    计算含税总金额。
    
    参数:
        price (float): 商品单价，必须大于0
        tax_rate (float): 税率，默认值为0.05
    返回:
        float: 最终含税总价
    """
    if price < 0:
        raise ValueError("商品单价不能为负数")
    total = price * (1 + tax_rate)
    return round(total, 2)

# 调用测试
item_cost = calculate_total(100.0)
print("计算结果示例:", item_cost)

运行结果示例：

计算结果示例: 105.0

在编写上述代码时，有几个关键规范需要注意：

• 函数命名规范：Python PEP 8 规范推荐使用纯小写字母加下划线（snake_case）命名函数，例如 get_user_info 或 calculate_total，避免使用驼峰命名法。
• 形参与实参的区别：定义在 def 头部圆括号里的变量（如 price, tax_rate）被称为形式参数（形参）；而在调用函数时传入的具体数值（如 100.0）被称为实际参数（实参）。
• 冒号与缩进约束：函数名行末必须使用英文字符冒号 :。函数体内部的所有有效语句必须保持严格统一的缩进深度（官方推荐 4 个空格），否则 Python 解释器会抛出 IndentationError 异常。

二、函数从定义到调用的操作流程

编写高质量的函数并不是直接敲出代码，而是包含明确的前期设计、编写实现与调用验证三个阶段。跳过输入输出设计直接堆砌代码，容易导致参数混乱或边界值报错。

下面通过一个温度换算函数的完整演练，展示上述步骤的落地过程：

# 步骤 1 & 2: 声明函数契约与签名
def celsius_to_fahrenheit(celsius):
    """将摄氏温度转换为华氏温度。"""
    # 步骤 3: 实现转换逻辑
    fahrenheit = (celsius * 9 / 5) + 32
    return fahrenheit

# 步骤 4: 调用验证
temp_c = 25.0
temp_f = celsius_to_fahrenheit(temp_c)

print("摄氏度:", temp_c)
print("转换后的华氏度示例:", temp_f)

运行结果示例：

摄氏度: 25.0
转换后的华氏度示例: 77.0

三、形参与实参传递规范及避坑准则

函数的调用灵活性主要来自于参数系统。Python 提供了位置参数、默认参数和关键字参数三种主流传参方式，但它们在混用时有着严谨的先后次序限制。

1. 位置参数与关键字参数

位置参数按照实参传入的相对次序依次与形参绑定；关键字参数则显式指出形参名称，例如 func(name="Alice", age=25)。使用关键字参数可以不必遵循形参的先后顺序，但必须牢记一条语法铁律：位置实参绝不能出现在任何关键字实参之后。例如 func(name="Alice", 25) 会直接触发 SyntaxError: positional argument follows keyword argument。

2. 可变默认参数的隐蔽陷阱

Python 函数的默认参数在 def 语句执行解析时被创建一次，并常驻在函数对象的 __defaults__ 属性中。如果将列表 [] 或字典 {} 作为默认参数，该可变对象将在函数的整个生命周期中被共享。请看下方的错误与正确写法对比：

# 错误示例：默认参数复用导致数据残留
def append_wrong(val, container=[]):
    container.append(val)
    return container

# 正确示例：使用 None 作为哨兵值
def append_correct(val, container=None):
    if container is None:
        container = []
    container.append(val)
    return container

print("错误写法两次调用结果示例:")
print("第1次:", append_wrong(1))
print("第2次:", append_wrong(2))  # 输出会意外包含 [1, 2]

print("正确写法两次调用结果示例:")
print("第1次:", append_correct(1))
print("第2次:", append_correct(2))

运行结果示例：

错误写法两次调用结果示例:
第1次: [1]
第2次: [1, 2]
正确写法两次调用结果示例:
第1次: [1]
第2次: [2]

四、返回值机制与作用域边界

函数完成运算后，通过 return 语句将数据返回给调用方，同时立即终止当前函数的执行流。若函数体内没有显式书写 return，或者仅书写单独的 return，函数将在执行完毕后隐式返回内置对象 None。

此外，Python 支持使用逗号分隔同时返回多个值，其底层实质是返回一个不可变元组（Tuple）：

def get_user_status(user_id):
    # 模拟查询用户身份与活跃状态
    name = "User_" + str(user_id)
    is_active = True
    score = 98.5
    return name, is_active, score  # 实质返回 (name, is_active, score)

# 解构赋值接收
user_name, active, user_score = get_user_status(101)
print("解构结果示例:", user_name, active, user_score)

运行结果示例：

解构结果示例: User_101 True 98.5

在变量访问方面，函数内部声明的变量属于局部作用域（Local Scope），只在函数执行期间有效，函数外部无法直接读取。如果需要在函数内部修改全局变量，虽然可以使用 global 关键字，但在工业级代码中强烈建议避免依赖全局可变状态，优先通过传参和返回值实现数据交互。

五、函数定义与调用核心规范全景总结

为了在实际编码中快速查验函数的规范性，下表与全景图对本文提及的语法结构、传参要求与代码健康度指标进行了系统梳理：

综上所述，掌握 Python 的 def 语法结构不仅在于记住关键字和缩进规则，更在于理解参数在内存中的传递逻辑与生命周期。在日常编码中坚持编写具有良好自解释性的命名、使用不可变对象作为默认形参，并在传参时维护清晰的位置次序，是写出健壮、优雅 Python 代码的关键基础。