Python函数完全指南：从入门到精通

一、函数是什么函数是一段组织好的、可重复使用的代码块用于执行特定的任务。通过函数我们可以提高代码复用性避免重复编写相同逻辑增强可读性将复杂逻辑拆分为有意义的模块便于测试和维护独立的功能单元更容易调试和修改实现抽象隐藏实现细节只暴露必要的接口在Python中函数是一等公民First-class Citizen这意味着函数可以像其他对象一样被赋值、传递和返回。二、函数的定义与调用2.1 基本语法使用def关键字定义函数def function_name(parameters): 文档字符串docstring- 描述函数功能 # 函数体 # 执行逻辑 return result # 可选一个完整的示例def calculate_bmi(weight_kg, height_m): 根据体重公斤和身高米计算BMI指数 if height_m 0: raise ValueError(身高必须大于0) bmi weight_kg / (height_m ** 2) return round(bmi, 2) # 调用函数 bmi calculate_bmi(70, 1.75) print(f您的BMI指数为{bmi}) # 输出您的BMI指数为22.862.2 文档字符串Docstring良好的文档字符串是专业代码的标志def fetch_user_data(user_id, include_profileTrue): 根据用户ID获取用户数据。 Args: user_id (int): 用户的唯一标识符 include_profile (bool): 是否包含用户详细资料默认为True Returns: dict: 包含用户信息的字典如果用户不存在则返回None Raises: ConnectionError: 当数据库连接失败时抛出 # 函数实现... pass # 查看文档字符串 print(fetch_user_data.__doc__) help(fetch_user_data) # 更详细的帮助信息三、参数传递深度解析参数是函数与外部世界通信的主要方式Python提供了极其灵活的参数系统。3.1 位置参数Positional Arguments最基本的参数传递方式按位置匹配def create_user(name, age, email): return f用户{name}年龄{age}邮箱{email} # 必须按顺序传递 print(create_user(张三, 28, zhangsanexample.com))3.2 默认参数Default Arguments为参数提供默认值使参数变为可选def create_user(name, age, emailNone, is_activeTrue): return { name: name, age: age, email: email or 未提供, is_active: is_active } # 可以只传递必填参数 user1 create_user(李四, 25) # 也可以覆盖默认值 user2 create_user(王五, 30, wangwuexample.com, False)⚠️ 重要陷阱默认参数是可变对象时# ❌ 错误示例 def add_item(item, items[]): # 默认列表在函数定义时创建所有调用共享 items.append(item) return items print(add_item(1)) # [1] print(add_item(2)) # [1, 2] ← 意外结果 # ✅ 正确做法 def add_item(item, itemsNone): if items is None: items [] items.append(item) return items print(add_item(1)) # [1] print(add_item(2)) # [2] ← 符合预期3.3 关键字参数Keyword Arguments通过参数名指定值提高可读性且顺序无关def config_server(host, port, protocolhttp, timeout30): return f{protocol}://{host}:{port} (timeout: {timeout}s) # 关键字参数调用 config config_server( hostlocalhost, port8080, timeout60, protocolhttps )3.4 可变参数*args- 接收任意数量的位置参数def sum_numbers(*args): 计算任意数量数字的和 total 0 for num in args: total num return total print(sum_numbers(1, 2, 3)) # 6 print(sum_numbers(10, 20, 30, 40)) # 100 print(sum_numbers()) # 0**kwargs- 接收任意数量的关键字参数def print_user_info(**kwargs): 打印用户信息支持任意字段 for key, value in kwargs.items(): print(f{key}: {value}) print_user_info(nameAlice, age25, cityNew York, jobEngineer) # 输出 # name: Alice # age: 25 # city: New York # job: Engineer3.5 参数组合顺序当同时使用多种参数时必须遵循以下顺序def complex_function( pos1, # 1. 位置参数 pos2, # 2. 位置参数 /, # 3. 斜线之前必须是位置参数Python 3.8 kw_only1, # 4. 关键字参数在*之后 *args, # 5. 可变位置参数 kw_only2None, # 6. 关键字参数带默认值 **kwargs # 7. 可变关键字参数 ): pass位置参数Positional-Only示例def divide(a, b, /): a和b只能通过位置传递 return a / b divide(10, 2) # ✅ 正确 # divide(a10, b2) # ❌ 错误不能使用关键字参数3.6 解包参数Argument Unpacking使用*和**将序列或字典解包为参数def greet(name, age): print(f{name} is {age} years old) # 列表解包 person [Alice, 30] greet(*person) # 等价于 greet(Alice, 30) # 字典解包 info {name: Bob, age: 25} greet(**info) # 等价于 greet(nameBob, age25)四、返回值4.1 返回单个值def square(x): return x ** 2 result square(5) # 254.2 返回多个值实际上是元组def get_stats(numbers): return min(numbers), max(numbers), sum(numbers) / len(numbers) min_val, max_val, avg get_stats([1, 2, 3, 4, 5]) print(min_val, max_val, avg) # 1 5 3.04.3 无返回值返回Nonedef log_message(msg): print(f[LOG] {msg}) # 没有return语句默认返回None result log_message(Test) print(result) # None4.4 提前返回def find_first_even(numbers): for num in numbers: if num % 2 0: return num # 找到第一个偶数立即返回 return None # 未找到 print(find_first_even([1, 3, 5, 7])) # None print(find_first_even([1, 2, 3, 4])) # 2五、变量的作用域5.1 LEGB规则Python查找变量时遵循LEGB顺序Local - 局部作用域函数内部Enclosing - 外层函数作用域Global - 全局作用域模块级别Built-in - 内置作用域Python内置名称x global # 全局变量 def outer(): x enclosing # 外层变量 def inner(): x local # 局部变量 print(x) # 输出: local inner() print(x) # 输出: enclosing outer() print(x) # 输出: global5.2 global 和 nonlocalcount 0 def increment(): global count # 声明使用全局变量 count 1 increment() print(count) # 1 def outer(): value 0 def inner(): nonlocal value # 修改外层函数的变量 value 1 print(value) inner() # 1 inner() # 2 outer()六、总结知识点核心要点函数定义def 函数名 参数 函数体 return参数类型位置参数、默认参数、关键字参数、*args、**kwargs返回值单个值、多个值元组、None作用域LEGB规则Local → Enclosing → Global → Built-in匿名函数lambda表达式适合简单场景最佳实践单一职责、命名规范、类型注解、保持简洁最后的话函数是Python编程的基石。掌握函数的各种特性和用法是写出高质量Python代码的关键。希望本文能帮助你系统性地理解和运用Python函数。记住好的函数不仅能让代码运行正确更能让代码易于理解和维护。持续学习持续进步。如果觉得本文有帮助欢迎分享给更多的Python爱好者