Python类中的self到底代表什么

栗子

发布时间：2026-10-30 | 8人浏览过

原创

深入解析 Python 类中 self 的本质含义、底层传递机制、多实例属性隔离原理与常见报错，系统梳理 self 的工作方式与实战细节。

在 Python 面向对象编程中，self 本质上代表当前调用该方法的具体对象实例本身。当我们在类外部执行 obj.method() 时，Python 解释器在底层会自动将该实例 obj 作为第一个参数隐式传递给方法中名为 self 的形参。理解了这种机制，就掌握了 Python 实例方法运作的根本钥匙。

一、self 的底层真相：方法调用的“语法糖”

初学者在学习 Python 类定义时，最常遇到的疑惑往往是：为什么定义方法时必须在第一个位置写上 self，而在实际调用时却完全不用传入这个参数？

这个现象的原因在于：我们平时使用的 instance.method(arg) 实际上是 Python 语言提供的一种便捷语法（即语法糖）。在 Python 虚拟机真正执行代码时，它会将该调用自动转换为 Class.method(instance, arg)。

class Person:
    def __init__(self, name):
        self.name = name

    def speak(self, words):
        print(f"{self.name} 说: {words}")

# 实例化对象
user = Person("张三")

# 方式 1：常规面向对象调用（常用风格）
user.speak("你好")

# 方式 2：显式通过类调用并将实例作为首个实参传入（底层等价形式）
Person.speak(user, "你好")

如上述代码所示，方式 1 与方式 2 的执行结果完全一致。这就直接证明了：在类中声明的每个普通函数本身归属于类对象，而 self 只是一个平平无奇的形式参数，专门用于在运行时接收调用该动作的具体实例指针。

图注：调用方法时，点号左边的对象被自动塞入方法签名的第一位，绑定给 self。

二、实例内存空间与数据隔离：为什么必须依赖 self

了解了调用形式后，我们需要追问更深层的问题：为什么不直接在方法内使用变量，非要加上 self. 前缀？

在 Python 的对象模型中，类定义本身是一个独立的代码块与命名空间，内存中只有一份；而通过类可以实例化出成百上千个具体的实例对象。每个实例都有属于自己的属性字典（即 __dict__）。

如果我们在方法内声明 x = 10，这仅仅是该函数执行时的局部变量，函数执行完毕后即被销毁，无法跨方法保持，更无法被实例记录。
而执行 self.x = 10，本质是向当前 self 所指向的实例对象的 __dict__ 中写入键值对。这就将数据永久保存在了该特定实例的生命周期内。

class Counter:
    def __init__(self):
        self.count = 0  # 挂载到当前实例的属性

    def increment(self):
        self.count += 1 # 修改当前实例的状态

c1 = Counter()
c2 = Counter()

c1.increment()
c1.increment()
print(c1.count)  # 输出: 2
print(c2.count)  # 输出: 0

当执行 c1.increment() 时，self 绑定的是 c1 的内存地址；当执行 c2.increment() 时，self 则指向 c2 的内存地址。正是 self 的存在，确保了多个对象实例共用同一份方法代码时，各自的状态与数据能够严格隔离、互不干扰。

图注：类方法仅一份物理代码，self 作为动态指针分派到具体实例的独立属性区。

三、self 是关键字还是命名约定？

另一个常见的认识误区是以为 self 是 Python 核心保留关键字（如 def、class、return 等）。

事实并非如此：self 在 Python 语法层面上不是关键字，它只是一个普通的标识符。从语法规则上讲，完全可以把它替换为任何合法名称：

class Example:
    def __init__(this, val):  # 语法合法，但违反规范！
        this.val = val

    def show(me):             # 同样合法，但极不推荐！
        print(me.val)

尽管上述代码在 Python 解释器中可以正常运行，但强烈禁止在生产环境这样书写。PEP 8 官方编码规范明确要求：

所有实例方法的第一个参数必须严格命名为 self。
所有类方法（被 @classmethod 装饰）的第一个参数必须严格命名为 cls。
静态方法（被 @staticmethod 装饰）无需隐式传递任何特定上下文，按普通函数传参。

图注：只有普通实例方法才以 self 作为首参数，类方法传递 cls，静态方法则不传。

四、初学者最常踩的 3 个 self 相关陷阱

1. 遗漏形参中的 self 导致 TypeError

很多刚从 C++、Java 转过来的开发者习惯了隐含的 this 机制，容易漏掉方法定义中的 self：

class Device:
    def start():  # 错误：未声明 self
        print("启动中...")

d = Device()
d.start()
# 报错：TypeError: Device.start() takes 0 positional arguments but 1 was given

排查与修复要点

报错信息明确指出“函数需要 0 个位置参数，但给出了 1 个”。那个凭空出现的“1 个参数”，正是解释器在调用时偷偷传递给它的 d 实例。只要在方法声明中补充 def start(self): 即可解决。

2. 访问类内属性或方法时遗漏 `self.` 导致 NameError

class Player:
    def __init__(self, score):
        self.score = score

    def show_score(self):
        # 错误：直接写 score 会寻找当前函数局部作用域及全局作用域，找不到变量！
        print(score) 

# 报错：NameError: name 'score' is not defined. Did you mean: 'self.score'?