Python类实例化陷阱：深入理解“缺少必需的位置参数”错误

本文深入探讨了Python中因类实例化不当导致方法调用时出现“缺少一个必需的位置参数”错误的原因。核心问题在于将类本身而非其实例赋值给变量，导致方法调用时`self`参数无法自动绑定。教程将详细解释正确实例化类的方法，并提供示例代码，帮助开发者避免此类常见错误。

在Python面向对象编程中，类（Class）是创建对象的蓝图，而对象（Object）或实例（Instance）则是类具体的实现。理解类与实例之间的区别，以及如何正确地实例化类，是编写健壮Python代码的基础。一个常见的错误是尝试在未正确实例化类的情况下调用其方法，这往往会导致“TypeError: missing 1 required positional argument”的错误。

理解Python中的类、实例与self

在Python中，当你定义一个类时，你实际上是创建了一个新的类型。例如：

class Dish_Washer:

  def heat_water(self):
    print("Water is heating")

  def wash_dishes(self):
    print("Dishes are washing")

  def open_door_malfunction(self):
    print("Door is open")    

  def start_cycle(self, is_on, door_closed):
    is_on = is_on
    door_closed = door_closed
    if door_closed == False:
      self.open_door_malfunction()
    elif is_on == True and door_closed == True:
      self.heat_water()
      self.wash_dishes()

在这个Dish_Washer类中，heat_water、wash_dishes、open_door_malfunction和start_cycle都是方法。这些方法中的第一个参数self是一个约定俗成的名称，它代表了方法被调用时所操作的那个对象（实例）本身。当通过一个实例调用方法时，Python会自动将该实例作为第一个参数传递给self。

立即学习“Python免费学习笔记（深入）”；

错误的实例化与方法调用

考虑以下代码片段：

dishwasher = Dish_Washer
dishwasher.start_cycle(True, True)

乍一看，这似乎是在创建一个Dish_Washer对象并调用其start_cycle方法。然而，dishwasher = Dish_Washer这一行并没有创建一个Dish_Washer类的实例。它仅仅是将Dish_Washer这个“类对象”本身赋值给了变量dishwasher。此时，dishwasher不再是一个具体的洗碗机，而是一个洗碗机的“图纸”。

Tellers AI

Tellers是一款自动视频编辑工具，可以将文本、文章或故事转换为视频。

78

查看详情

当你接着调用dishwasher.start_cycle(True, True)时，Python会尝试在Dish_Washer类上查找并执行start_cycle方法。由于这不是通过一个实例调用的，Python不会自动为self参数绑定任何值。因此，它会将你传入的第一个参数True（预期是is_on）误认为是self，而第二个参数True（预期是door_closed）则会被认为是is_on。这样一来，door_closed参数就没有任何值传入，从而导致Python抛出以下错误：

Dish_washer.start_cycle() missing 1 required positional argument: 'door_closed'

这个错误信息明确指出，start_cycle方法缺少了door_closed这个必需的位置参数。根本原因在于self参数没有被正确处理，导致后续的参数绑定错位。

正确的类实例化与方法调用

要正确地创建一个类的实例，你需要使用括号()来调用类名，就像调用一个函数一样。这将执行类的构造函数（如果定义了__init__方法），并返回一个该类的新实例。

dishwasher = Dish_Washer() # 正确实例化：创建一个Dish_Washer对象

现在，dishwasher变量持有的才是一个真正的Dish_Washer对象。当你通过这个对象调用方法时，Python会确保self参数被正确地绑定到dishwasher实例本身。

# 完整的正确示例
class Dish_Washer:

  def heat_water(self):
    print("Water is heating")

  def wash_dishes(self):
    print("Dishes are washing")

  def open_door_malfunction(self):
    print("Door is open")    

  def start_cycle(self, is_on, door_closed):
    # 这里将传入的is_on和door_closed值重新赋给同名局部变量，
    # 实际上并未使用实例属性。如果需要存储状态，应使用self.is_on = is_on等
    # 但对于演示方法调用，当前代码逻辑是有效的。
    if door_closed == False:
      self.open_door_malfunction()
    elif is_on == True and door_closed == True:
      self.heat_water()
      self.wash_dishes()


dishwasher = Dish_Washer() # 正确实例化
dishwasher.start_cycle(True, True) # 正确调用方法

运行上述修正后的代码，你将得到预期的输出：

Water is heating
Dishes are washing

注意事项与总结

1. 始终使用括号()实例化类： 当你想要创建一个类的具体对象（实例）时，务必在类名后加上括号，例如MyClass()。
2. 理解self的作用： self是Python实例方法的第一个参数，它在方法被调用时自动指向调用该方法的实例。这是实例方法能够访问和修改实例属性的关键。
3. 区分类和实例： MyClass（不带括号）代表类本身，而my_instance = MyClass()代表该类的一个具体实例。只有通过实例才能调用实例方法。
4. 错误信息解析： 当你看到“TypeError: missing 1 required positional argument: 'some_param'”这样的错误，并且你确定已经提供了所有参数时，首先检查你是否正确地实例化了类。很可能self参数被错误地绑定到了你传入的第一个实际参数上。

通过遵循这些基本原则，你可以避免常见的类实例化错误，并更有效地利用Python的面向对象特性来构建清晰、可维护的代码。

以上就是Python类实例化陷阱：深入理解“缺少必需的位置参数”错误的详细内容，更多请关注php中文网其它相关文章！