Python多类示例报错：如何排查修复、优化代码并避免复发？

一、代码常见问题分析（针对Students/Course多类场景） #

以下是新手写这类代码最容易踩的坑：

• 类方法漏传self参数
  定义类的实例方法时必须加self作为第一个参数，比如写def get_name():会直接报错TypeError，正确写法是def get_name(self):。self是实例本身的引用，不加的话方法没法访问实例属性。
• 类属性和实例属性搞混
  比如在Course类里直接写students = []，这是类属性，所有Course实例会共享同一个列表，添加学生时会串数据。正确的做法是在__init__方法里定义self.students = []，每个实例有自己的学生列表。
• 实例属性未初始化
  如果在Students类的__init__里没给name、stu_id这些属性赋值，后面调用student.name会报AttributeError。必须在__init__里用self.属性名 = 值完成初始化。
• 实例化时参数不匹配
  比如__init__要求传name和stu_id，但实例化时写Students()，会直接报错缺少参数。调用时必须传够__init__定义的必填参数。
• 类之间关联逻辑写错
  比如想让Student关联对应的Course，结果把student.course = Course("数学", "MATH101")写成了student.course = "数学"，后续访问student.course.course_id就会报错，因为字符串没有course_id属性。

二、代码效率提升建议 #

• 区分类属性和实例属性
  把所有实例共享的固定值设为类属性，比如所有课程的学分都是3，就写class Course: credit = 3，不用每个Course实例都存一份credit，节省内存。
• 用合适的数据结构存关联对象
  如果Course需要频繁判断某个学生是否已加入，用set代替list存学生，比如self.students = set()，判断student in self.students的速度会从O(n)变成O(1)，数据量大时差异明显。
• 缓存重复计算的结果
  比如Student类里需要频繁获取关联课程的总学分，可以用@property加缓存：

  class Students:
      def __init__(self, name, stu_id):
          self.name = name
          self.stu_id = stu_id
          self._total_credit = None
          self.courses = []
  
      @property
      def total_credit(self):
          if self._total_credit is None:
              self._total_credit = sum(course.credit for course in self.courses)
          return self._total_credit
  

  这样第一次计算后会缓存结果，后续直接读取，不用重复遍历课程列表。
• 拆分复杂方法
  不要把“添加学生+计算人数+发送通知”塞进一个方法里，拆成add_student()、get_student_count()、send_notification()三个独立方法，代码更清晰，也方便单独调试和复用。

三、避免此类错误的实用技巧 #

• 小步测试，写一点测一点
  写完__init__就立刻实例化对象，打印属性确认没问题；写完一个方法就调用测试，比如：

  class Students:
      def __init__(self, name, stu_id):
          self.name = name
          self.stu_id = stu_id
  
  # 写完就测
  s1 = Students("张三", "2024001")
  print(s1.name, s1.stu_id)  # 确认属性赋值正确
  

  不要等整个代码写完再运行，小问题早发现早解决。
• 靠IDE实时检查错误
  用VS Code或PyCharm写代码，它们会实时标红self缺失、属性拼写错误、参数不匹配这类问题，不用等到运行才报错。
• 写文档字符串理清逻辑
  给每个类和方法写清楚功能、参数，比如：

  class Course:
      """
      课程类，管理课程信息和选课学生
      :param course_name: 课程名称（字符串）
      :param course_id: 课程编号（字符串）
      """
      def __init__(self, course_name, course_id):
          self.course_name = course_name
          self.course_id = course_id
          self.students = []
  

  写的时候能帮你理清参数需求，避免漏传或错传。
• 学会读错误信息
  错误信息里的行号和提示直接指向问题：
  • 看到AttributeError就查对应的属性有没有在__init__里定义，或者有没有拼写错；
  • 看到TypeError就看方法参数数量和调用时传的是否匹配；
  • 看到NameError就查变量或类名有没有写错。
• 先抄基础示例再扩展
  写自己的类之前，先看Python官方的类定义基础示例，把self的使用、属性初始化这些基础逻辑搞对，再慢慢加自己的功能，不要上来就写复杂的关联逻辑。

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