Python中如何避免函数参数修改原变量？最佳实践问询

这确实是Python里操作可变对象（比如列表、字典）时很容易踩的坑！你提到的传入副本是有效的解决办法，但参数多的时候反复写.copy()确实挺繁琐的。我来分享几个更优雅的最佳实践：

• 把复制逻辑封装到函数内部
  与其让每个调用方都手动传副本，不如把复制操作放在函数里。这样调用方只需要传原变量，函数自己处理隔离，代码更简洁也更易维护：

  def update_user_info(user_dict):
      # 函数内部创建字典副本，原字典不受影响
      updated_user = user_dict.copy()
      updated_user["last_login"] = "2024-05-20"
      return updated_user
  
  original_user = {"name": "Alice", "age": 30}
  updated = update_user_info(original_user)
  # original_user 还是 {"name": "Alice", "age": 30}
  

• 优先使用不可变对象作为参数
  如果业务场景允许，尽量用元组、字符串、frozenset这类不可变类型。因为不可变对象本身无法被修改，函数里只能生成新的对象返回，从根源上避免了原变量被修改的问题：

  def extend_tags(existing_tags):
      # 不可变元组只能生成新元组返回
      return existing_tags + ("python", "best-practice")
  
  original_tags = ("coding", "tips")
  new_tags = extend_tags(original_tags)
  # original_tags 依然是 ("coding", "tips")
  

  当然，这个方法要看你的业务逻辑是否适合用不可变类型，毕竟不是所有场景都能替换。

• 用装饰器批量处理参数复制
  如果你的项目里有很多函数都需要隔离原变量，可以写一个通用装饰器，自动为可变参数创建副本。这样不用每个函数都重复写copy代码：

  from functools import wraps
  
  def isolate_args(func):
      @wraps(func)
      def wrapper(*args, **kwargs):
          # 为所有支持copy方法的参数创建副本
          copied_args = [arg.copy() if hasattr(arg, "copy") else arg for arg in args]
          copied_kwargs = {k: v.copy() if hasattr(v, "copy") else v for k, v in kwargs.items()}
          return func(*copied_args, **copied_kwargs)
      return wrapper
  
  @isolate_args
  def process_multi_data(list_a, dict_b):
      list_a.append("new element")
      dict_b["status"] = "processed"
      return list_a, dict_b
  
  my_list = [1, 2, 3]
  my_dict = {"id": 1001}
  processed_list, processed_dict = process_multi_data(my_list, my_dict)
  # my_list 和 my_dict 都保持原样
  

• 用类型提示和文档明确行为
  不管用哪种方法，记得在函数的文档字符串里明确说明是否会修改原参数，再配合类型提示，让调用方一眼就能知道函数的行为：

  from typing import Dict, List
  
  def filter_active_users(users: List[Dict]) -> List[Dict]:
      """过滤出活跃用户，返回新列表，**不会修改原列表**"""
      active_users = []
      for user in users:
          # 这里如果要修改单个user字典，也记得先copy
          user_copy = user.copy()
          user_copy["is_active"] = user.get("login_count", 0) > 0
          active_users.append(user_copy)
      return active_users
  

总结一下，最通用且友好的方式还是在函数内部创建副本，把隔离逻辑封装起来；如果有大量重复需求，装饰器能帮你减少冗余代码；不可变对象则是从设计层面避免问题的思路。

内容的提问来源于stack exchange，提问作者kudich