一、参数传递错误

1. 参数数量不匹配

错误示例：

def greet(name, age):
    print(f"{name} is {age} years old")

greet("Alice")  # 缺少一个参数

报错信息：

TypeError: greet() missing 1 required positional argument: 'age'

解决方案：

1. 提供所有必需参数

greet("Alice", 25)

2. 使用默认参数定义函数

def greet(name, age=None):
    print(f"{name} is {age} years old" if age else f"Hello, {name}!")

2. 参数顺序错误

错误示例：

def divide(a, b):
    return a / b

result = divide(0, 5)  # 正确
result = divide(5, 0)  # 除零错误

解决方案：

1. 使用关键字参数明确指定

result = divide(b=5, a=0)

2. 添加参数检查

def divide(a, b):
    if b == 0:
        return float('inf')  # 或其他错误处理
    return a / b

二、返回值处理错误

3. 忽略返回值

错误示例：

def get_user_info():
    # 从数据库获取数据
    return {"name": "Alice", "age": 25}

get_user_info()  # 返回值未被使用

解决方案：

user_info = get_user_info()
print(user_info["name"])

4. 错误解包多个返回值

错误示例：

def get_coordinates():
    return 10, 20

x, y, z = get_coordinates()  # 返回值数量不匹配

解决方案

# 方法1：正确接收返回值
x, y = get_coordinates()

# 方法2：使用_忽略不需要的值
x, _ = get_coordinates()

三、作用域相关错误

5. 未声明全局变量

错误示例：

count = 0

def increment():
    count += 1  # 尝试修改全局变量

increment()  # UnboundLocalError

解决方案：

count = 0

def increment():
    global count  # 声明使用全局变量
    count += 1

6. 闭包变量绑定问题

错误示例：

functions = []
for i in range(3):
    functions.append(lambda: print(i))  # 所有函数都打印2

for f in functions:
    f()

解决方案：

# 方法1：使用默认参数捕获当前值
functions = []
for i in range(3):
    functions.append(lambda x=i: print(x))

# 方法2：使用functools.partial
from functools import partial
functions = [partial(print, i) for i in range(3)]

四、可变对象作为默认参数

7. 可变默认参数陷阱

错误示例：

def add_item(item, items=[]):
    items.append(item)
    return items

print(add_item(1))  # [1]
print(add_item(2))  # [1, 2] 不是预期的[2]

解决方案：

def add_item(item, items=None):
    if items is None:
        items = []
    items.append(item)
    return items

五、递归函数错误

8. 缺少基准条件

错误示例：

def factorial(n):
    return n * factorial(n-1)  # 无限递归

factorial(5)  # RecursionError

解决方案：

def factorial(n):
    if n == 0:  # 基准条件
        return 1
    return n * factorial(n-1)

六、类型相关错误

9. 类型不匹配

错误示例：

def greet(name: str):
    print(f"Hello, {name}!")

greet(123)  # 类型不符合但不会报错

解决方案：

# 方法1：运行时类型检查
def greet(name: str):
    if not isinstance(name, str):
        raise TypeError("name必须是字符串")
    print(f"Hello, {name}!")

# 方法2：使用类型转换
def greet(name):
    print(f"Hello, {str(name)}!")

七、装饰器使用错误

10. 装饰器未保留元数据

错误示例：

def my_decorator(func):
    def wrapper():
        return func()
    return wrapper

@my_decorator
def greet():
    """问候函数"""
    print("Hello")

print(greet.__name__)  # 输出wrapper而不是greet

解决方案：

from functools import wraps

def my_decorator(func):
    @wraps(func)  # 保留原始函数信息
    def wrapper():
        return func()
    return wrapper

八、最佳实践总结

1. 参数验证：在函数开始处验证参数有效性
2. 明确返回值：确保函数返回值类型一致
3. 异常处理：合理使用try-except捕获异常
4. 文档注释：为函数编写清晰的docstring
5. 单元测试：为关键函数编写测试用例
6. 类型提示：使用类型注解提高代码可读性(Python 3.5+)

def safe_divide(a: float, b: float) -> float:
    """安全除法运算
    
    参数:
        a: 被除数
        b: 除数
        
    返回:
        除法结果
        
    异常:
        ValueError: 当除数为0时抛出
    """
    if b == 0:
        raise ValueError("除数不能为0")
    return a / b

通过避免这些常见错误并遵循最佳实践，你的Python函数将更加健壮、可维护和可靠。