Python 函数核心概念与实战指南

注意：默认参数只在函数定义时计算一次。如果使用可变对象（如列表或字典）作为默认值，可能会引发意外行为，因为所有调用共享同一个对象实例。

关键字参数

当函数参数较多时，可以通过指定参数名来赋值，这就是关键字参数。这种方式提高了代码的可读性，且允许跳过中间参数。

def create_user(username, age, email=None):
    print(f"User: {username}, Age: {age}, Email: {email}")

# 按位置传参
create_user('Tom', 25)

# 使用关键字参数，顺序可打乱
create_user(age=30, username='Jerry', email='[email protected]')

关键字参数让调用者意图更明确，特别是在参数含义容易混淆时。

可变参数

有时候我们需要处理不定数量的参数。Python 提供了 *args 和 **kwargs 来实现这一点。

• *args 接收任意数量的位置参数，打包成元组。
• **kwargs 接收任意数量的关键字参数，打包成字典。

def log_messages(*args, **kwargs):
    print("Positional args:", args)
    print("Keyword args:", kwargs)

log_messages('error', 'warning', level='high', source='server')

这在编写通用工具函数或装饰器时特别有用，能够灵活适配不同的调用场景。

返回值

return 语句用于中断函数执行并返回结果。如果没有显式返回，函数默认返回 None。

def add(a, b):
    if a > 0 and b > 0:
        return a + b
    return None

result = add(5, 3)
if result:
    print(f"Sum is {result}")

多个返回值在 Python 中实际上是返回一个元组，解包后可以分别获取。

文档字符串 (Docstrings)

Python 支持文档字符串（Docstrings），用于描述函数的用途、参数和返回值。这是编写高质量库的关键。

def multiply(x, y):
    """
    计算两个数的乘积。
    
    Args:
        x (int): 第一个数字
        y (int): 第二个数字
        
    Returns:
        int: 乘积结果
    """
    return x * y

help(multiply)  # 查看帮助信息

良好的文档能让维护者快速理解代码意图，减少沟通成本。养成写 Docstring 的习惯，是对自己和他人的负责。