Python定义类时常见报错：遗漏self或缩进错误怎么修

在 Python 面向对象编程中，初学者定义类时最容易遇到的两类阻碍是遗漏 self 导致的实参溢出或作用域找不到变量，以及缩进不符合规范引发的语法解析中断。这两类问题会直接抛出 TypeError、NameError、IndentationError 或 TabError。要彻底修复它们，关键在于理解 Python 解释器在调用实例方法时自动传入实例的底层机制，以及基于冒号和 4 个空格的刚性分块规则。本文针对这些报错的具体表现、根本原因与修复步骤进行逐项拆解。

一、遗漏 self 引发的典型报错与修复方法

在 Python 的类定义中，普通实例方法必须显式将 self 作为第一个形参声明，在方法内部访问实例属性或调用其他实例方法时也必须显式加上 self. 前缀。遗漏 self 在不同调用场景下会呈现两种截然不同的报错特征。

1. 报错现象一：方法定义遗漏 self，调用时报参数数量错误

当通过类实例调用无参或带参方法时，如果方法定义阶段没有在最左侧声明 self 形参，解释器会抛出类似 TypeError: takes 0 positional arguments but 1 was given 的异常。

class Device:
    # 错误：普通实例方法首位缺少 self 形参
    def get_status():
        return "online"

device = Device()
# 调用时触发报错
print(device.get_status())

运行上述代码后，终端输出的示例报错信息如下：

Traceback (most recent call last):
  File "demo.py", line 8, in <module>
    print(device.get_status())
TypeError: Device.get_status() takes 0 positional arguments but 1 was given

原因解释：虽然在调用 device.get_status() 时括号内没有填入任何参数，但 Python 底层会将该语法糖自动转换为 Device.get_status(device)，也就是把当前实例 device 作为第一个位置参数隐式传入。而 get_status 函数定义声明了 0 个形参，接收到 1 个实参自然引发类型异常。

正确修复代码：在方法定义的形参列表首位补齐 self 即可。

class Device:
    # 正确修复：首个形参显式声明 self
    def get_status(self):
        return "online"

device = Device()
print(device.get_status())  # 示例输出：online

2. 报错现象二：类内访问属性或调用同类方法漏写 self. 前缀

在方法内部如果直接书写属性名而缺少 self.，Python 会尝试在局部作用域（函数内局部变量）和全局作用域中查找该标识符，一旦找不到就会抛出 NameError；如果在 __init__ 构造器中只写 name = name，属性将沦为临时局部变量，函数执行完毕后即被回收，导致实例无法保存数据。

class Student:
    def __init__(self, name, score):
        # 错误：未绑定至 self，只创建了局部变量
        name = name
        score = score

    def calculate_grade(self):
        # 错误：直接使用 score，触发 NameError
        if score >= 60:
            return "Pass"
        return "Fail"

s = Student("小明", 85)
s.calculate_grade()

终端示例报错输出如下：

Traceback (most recent call last):
  File "demo.py", line 14, in <module>
    s.calculate_grade()
  File "demo.py", line 8, in calculate_grade
    if score >= 60:
NameError: name 'score' is not defined

正确修复代码：使用 self.属性名 进行赋值和访问。若方法内需要调用本类的其他方法，同样必须以 self.方法名() 形式发起调用。

class Student:
    def __init__(self, name, score):
        self.name = name          # 挂载到实例命名空间
        self.score = score

    def calculate_grade(self):
        if self.score >= 60:       # 访问实例属性
            return "Pass"
        return "Fail"

    def report(self):
        # 通过 self 调用同类的其他实例方法
        grade = self.calculate_grade()
        return f"{self.name} 的评级为: {grade}"

s = Student("小明", 85)
print(s.report())  # 示例输出：小明 的评级为: Pass

3. 特殊场景：何时不需要 self？

如果类中的某个方法既不需要读取也不需要修改类或实例的任何属性，仅作为逻辑上归属于该类的独立工具函数，可以使用 @staticmethod 装饰器修饰。被修饰的静态方法不会被传入实例参数，因此不能且不需要声明 self。

class MathTool:
    @staticmethod
    def add(a, b):  # 纯工具计算，不需要 self
        return a + b

print(MathTool.add(3, 5))  # 示例输出：8

二、类定义中的缩进错误与修复排查

Python 放弃了许多编程语言采用的各类大括号 {}，完全依靠缩进来划分代码块逻辑范围。类定义涉及模块顶层、类主体、方法主体、内部逻辑分支等多个层级，对齐出现微小偏差就会在编译期直接报错，导致程序甚至无法进入执行阶段。

1. 报错一：IndentationError: expected an indented block

当书写了 class ClassName: 或 def method(self): 后，英文冒号告知 Python 下一行必须开启一个新的缩进代码块。如果下一行代码与定义行平级，或者定义之后留空没有填入有效语句，就会触发该报错。

class OrderManager:
    def process_order(self):
    # 冒号后直接换行至同级或空内容，触发解析失败
    def cancel_order(self):
        pass

终端示例报错输出如下：

  File "demo.py", line 4
    def cancel_order(self):
    ^
IndentationError: expected an indented block after function definition on line 2

修复方法：任何包含冒号的语句下必须至少存在一行缩进内容。如果该类或方法暂未想好具体实现，必须使用 pass 占位，或使用文档字符串注释：

class OrderManager:
    def process_order(self):
        pass  # 使用 pass 占位，避免语法解析错误

    def cancel_order(self):
        """取消订单逻辑（待完善）"""
        pass

2. 报错二：IndentationError: unindent does not match any outer indentation level

该错误表示“回退缩进时，未能与任何已有的外层缩进层级对齐”。常见于手动敲击空格键时手误多敲或少敲了空格，导致某一行缩进例如变成了 3 格或 5 格，无法被 Python 的语法树匹配到任何层级。

class User:
    def __init__(self, username):
        self.username = username
       self.is_active = True  # 错误：此处只有 3 个空格，无法对齐上行的 4 空格或外层

修复方法：检查报错行开头的空格数，严格按照当前代码块的层级补齐到 4 的倍数（与同层级的前后代码左边缘对齐）。

3. 报错三：TabError: inconsistent use of tabs and spaces in indentation

在 Python 3 中，严格禁止在同一个代码文件的缩进中混合使用制表符（Tab）和空格（Space）。尽管在很多文本编辑器中，一个制表符的显示宽度恰好与 4 个空格相同，但它们在 ASCII 码层面是两个完全不同的字符（0x09 与 0x20），解释器会直接拦截并抛出 TabError。

排查与修复步骤：

1. 开启编辑器不可见字符显示：在 VS Code 中搜索并开启 "editor.renderWhitespace": "all"，此时空格会显示为小圆点，制表符会显示为右箭头。
2. 统一转换制表符：在编辑器右下角状态栏点击缩进设置，选择 Indent Using Spaces（使用空格缩进），将缩进宽度固定设为 4，然后执行 Convert Indentation to Spaces（将制表符转换为 4 个空格）。
3. 使用静态检查工具：在终端执行 Python 自带的 tab 检查模式或代码格式化工具校验：

   # 使用 Python 严格语法检查当前脚本
   python -m py_compile your_file.py

4. 逻辑隐患：方法意外退回顶格脱离类定义

有时缩进错误不会直接报错，但会产生诡异的运行时逻辑异常。例如编写类时，某个方法的 def 忘记缩进 4 格，顶格写在第 0 列。此时 Python 解释器会将其解析为全局普通函数，而不是类的成员方法。之后在外部通过实例调用 instance.method() 时，会报 AttributeError: 'ClassName' object has no attribute 'method'。

class Calculator:
    def add(self, a, b):
        return a + b

# 错误：def 顶格书写，导致 subtract 变成了模块级函数，脱离了 Calculator 类
def subtract(self, a, b):
    return a - b

calc = Calculator()
calc.add(10, 5)        # 正常工作
calc.subtract(10, 5)   # 报错：AttributeError: 'Calculator' object has no attribute 'subtract'

三、类定义报错排查决策与速查总结

为了在遇到类定义报错时能够快速定位，以下对照表归纳了错误日志关键字、触发根因与核心修复操作：

编写 Python 类时，只需恪守两条基础准则：“类内实例方法首位必带 self，内部访问成员必加 self.”，以及“冒号必有后随缩进，缩进严格使用 4 个纯空格”。遵循这两条核心规则，即可在编码初期规避绝大多数类定义相关的运行与解析异常。