Python的实例方法把我坑惨了,原来self和cls的区别这么大

简介: 本文通过小唐编写用户管理系统的实际案例,深入剖析Python中`self`(实例引用)与`cls`(类引用)的本质区别:`self`属于实例方法,操作具体对象;`cls`属于类方法,操作类本身及支持继承。强调二者不可互换,方法类型由装饰器决定,而非参数名。

小唐那天在写一个用户管理系统,需要给用户类加一个“从字典创建用户”的功能。

他的思路很简单:写一个方法,接收一个字典,把里面的字段取出来,创建用户实例。他觉得这个方法不需要访问某个具体用户的属性,于是写成了这样:

class User:
   def __init__(self, name, age):
       self.name = name
       self.age = age

   def from_dict(self, data):
       return User(data["name"], data["age"])

调用时他写:

user = User.from_dict({"name": "Alice", "age": 30})

直接报错:

TypeError: from_dict() missing 1 required positional argument: 'data'

小唐愣了:“我传了data啊,为什么说少了一个参数?”

他试着通过实例调用:

u = User("Bob", 25)
new_user = u.from_dict({"name": "Alice", "age": 30})

这次不报错了,但from_dict内部用的是self,而他传进去的u和data完全没关系。方法能跑,但语义很怪:他用一个已有的用户实例,去创建一个新用户。这个已有实例除了“提供一个方法入口”之外,没有任何作用。

代理 IP 使用小技巧 让你的数据抓取效率翻倍 (28).png

同事看了一眼说:“你这里应该用@classmethod,第一个参数写cls,不要写self。self是实例,cls是类。你写的是实例方法,却想当类方法用。”

小唐把代码改成:

class User:
   def __init__(self, name, age):
       self.name = name
       self.age = age

   @classmethod
   def from_dict(cls, data):
       return cls(data["name"], data["age"])

User.from_dict(...)直接就能调,不需要先创建实例。而且子类调用时,cls是子类,返回的也是子类实例。

“原来self和cls不是‘两种写法’,而是‘两种方法的第一个参数’。方法的类型决定了第一个参数是谁。”

这个认知,就是很多人对实例方法、类方法、静态方法感到混乱的根源:**self和cls不是可以随便替换的名字,它们分别属于不同的方法类型,代表不同的东西。**

先看一个最直观的对比

class Demo:
   def instance_method(self):
       print(f"self 是: {self}")

   @classmethod
   def class_method(cls):
       print(f"cls 是: {cls}")

   @staticmethod
   def static_method():
       print("没有 self 也没有 cls")

调用结果:

d = Demo()

d.instance_method()    # self 是: <Demo object at 0x...>,实例
Demo.class_method()    # cls 是: <class 'Demo'>,类
d.class_method()       # cls 是: <class 'Demo'>,还是类,不是实例
Demo.static_method()   # 没有 self 也没有 cls

关键差异:

  • self指向实例,是对象本身。
  • cls指向类,是类本身。
  • 实例方法必须通过实例调用,self自动绑定到那个实例。
  • 类方法通过类或实例调用都可以,cls始终绑定到类。
  • 静态方法没有隐式参数。

用一个生活场景来理解。

你有一个公司,公司里有员工。

self是员工本人。员工说“我要请假”,这个“我”指的是具体的某个员工。他知道自己的工号、自己的部门、自己的工资。

cls是公司这个组织。公司说“我们要招人”,这个“我们”指的是公司整体,不是某个具体员工。它知道公司的名称、公司的规章制度,但不知道某个员工的私人信息。

区别一目了然:self代表“某一个具体的个体”,cls代表“这一类事物的整体”。

self:实例的引用

self是实例方法的第一个参数,指向调用该方法的实例。

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

   def greet(self):
       return f"Hello, {self.name}"

u = User("Alice")创建实例,u.greet()调用时,Python自动把u作为self传入。self.name就是u.name。

self不是关键字,只是一个约定俗成的名字。你完全可以写成this或者obj:

class User:
   def greet(this):
       return f"Hello, {this.name}"

但永远不要这么做。self是Python社区的强约定,所有读代码的人都默认第一个参数叫self。改成别的名字,代码能跑,但可读性会大打折扣,而且会被linter警告。

self的核心能力是访问实例属性:

class Counter:
   def __init__(self):
       self.count = 0

   def increment(self):
       self.count += 1  # 修改的是这个实例的 count

每个实例有自己的count,互不干扰。self让方法知道“我操作的是哪个实例的数据”。

cls:类的引用

cls是类方法的第一个参数,指向调用该方法的类。

class User:
   species = "human"

   @classmethod
   def get_species(cls):
       return cls.species

User.get_species()调用时,cls是User。cls.species就是User.species。

cls的核心能力是访问类属性、创建实例、感知调用类:

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

   @classmethod
   def create(cls, name):
       return cls(name)  # 用 cls 创建实例

create用cls(name)而不是User(name),这样在子类调用时,创建的是子类实例。

cls同样是约定名,不是关键字,但同样不要改。

坑一:在实例方法里用 cls

class User:
   def greet(cls):  # 参数名叫 cls,但这是实例方法
       return f"Hello"

这个方法的第一个参数虽然叫cls,但它仍然是实例方法。通过实例调用时,cls收到的是实例,不是类。

u = User()
u.greet()  # 能跑,但 cls 是 u,不是 User
User.greet()  # TypeError: missing 1 required positional argument

参数名不会改变方法的类型。方法的类型由装饰器决定,不是由第一个参数的名字决定。把self写成cls不会让实例方法变成类方法,只会让读代码的人困惑。

坑二:在类方法里用 self

class User:
   @classmethod
   def greet(self):  # 参数名叫 self,但这是类方法
       return f"Hello, {self.name}"  # AttributeError

@classmethod的第一个参数收到的是类,不是实例。参数名叫self不会改变这个事实。self.name会去找User.name这个类属性,找不到就报AttributeError。

@classmethod里访问实例属性是根本性的错误:类方法不知道“具体是哪个实例”,因为调用时可能根本没有实例。

坑三:用实例方法实现工厂

这就是小唐踩的坑。

class User:
   def from_dict(self, data):
       return User(data["name"], data["age"])

from_dict被定义成实例方法,第一个参数是self。但这个方法根本不需要访问实例状态,它只是“接收一个字典,创建一个新用户”。用实例方法实现,导致调用时必须先有一个实例,语义上很别扭。

正确的做法是用@classmethod:

@classmethod
def from_dict(cls, data):
   return cls(data["name"], data["age"])

@classmethod不要求有实例,User.from_dict(...)直接调用,cls自动绑定到User。

判断标准:方法需要访问实例属性吗? 需要,用实例方法(self)。不需要,但需要创建实例或访问类属性,用类方法(cls)。

坑四:在类方法里写死类名

class User:
   @classmethod
   def from_dict(cls, data):
       return User(data["name"], data["age"])  # 写死了 User

cls参数摆在那儿没用,创建实例时写死了User。子类调用SubUser.from_dict(...),返回的还是User,不是SubUser。

@classmethod
def from_dict(cls, data):
   return cls(data["name"], data["age"])  # 用 cls

cls(...)让子类调用时返回子类实例。这是@classmethod存在的核心价值之一。

坑五:混淆 self 和 cls 的绑定时机

实例方法的self在调用时绑定到实例。类方法的cls在调用时绑定到类。

class User:
   def instance_method(self):
       return self

   @classmethod
   def class_method(cls):
       return cls

u = User()

print(u.instance_method() is u)      # True,self 是 u
print(User.class_method() is User)   # True,cls 是 User
print(u.class_method() is User)      # True,通过实例调用,cls 仍然是 User
print(u.class_method() is u)         # False,cls 不是实例

通过实例调用类方法时,cls仍然是类,不是实例。这个行为容易让人误以为“通过实例调用就会传实例”,实际上类方法永远不接收实例。

坑六:staticmethod 里想用 self 或 cls

class User:
   @staticmethod
   def greet():
       return f"Hello, {self.name}"  # NameError: self 不存在

@staticmethod没有隐式参数,既没有self也没有cls。方法体里引用self或cls都会报NameError。

静态方法如果需要访问实例或类,就不应该用@staticmethod。它适合的是“完全独立于实例和类的工具函数”。

那 self 和 cls 能互换吗?

不能。

self和cls不是“同一个东西的两个名字”。它们代表不同的对象,属于不同的方法类型。

# 实例方法:self 是实例
def method(self): ...

# 类方法:cls 是类
@classmethod
def method(cls): ...

# 静态方法:没有隐式参数
@staticmethod
def method(): ...

把self写成cls,方法仍然是实例方法,cls收到的是实例。把cls写成self,方法仍然是类方法,self收到的是类。参数名不改变方法类型,只改变可读性。

方法类型由装饰器决定,第一个参数的名字只是约定。 但约定极其重要,因为它们向读代码的人传递了“这个方法操作的是什么”的信号。

什么时候用 self,什么时候用 cls?

判断标准:

方法需要访问或修改实例属性:用实例方法,第一个参数self。

方法需要创建实例、访问类属性、或者需要感知调用类(支持继承):用类方法,第一个参数cls。

方法既不需要实例也不需要类,只是逻辑上属于这个类的工具函数:用静态方法,没有隐式参数。

方法需要访问实例属性,但也需要类级别的信息:实例方法里可以用self.__class__或type(self)拿到类,但更清晰的做法是拆成两个方法,或者用@classmethod配合实例参数。

不确定:先写实例方法。如果发现方法体里根本没用到self,再考虑改成@classmethod或@staticmethod。

一个容易忽略的细节:self 在继承中的多态

self在继承中有一个强大的特性:它指向的是实际实例的类型,不是定义方法的类的类型。

class Animal:
   def speak(self):
       return f"{self.__class__.__name__} makes a sound"

class Dog(Animal):
   pass

d = Dog()
print(d.speak())  # "Dog makes a sound",self 是 Dog 实例

speak定义在Animal里,但self是Dog实例,self.__class__是Dog。这就是多态的基础:父类的方法可以操作子类的实例。

cls在继承中也有类似的特性:cls是实际调用类的类型。

class Animal:
   @classmethod
   def create(cls):
       return cls()

class Dog(Animal):
   pass

print(type(Dog.create()))  # <class 'Dog'>,cls 是 Dog

两者的区别在于:self绑定到实例,cls绑定到类。在继承链中,它们都指向“最具体的那个类型”,但一个是实例层面,一个是类层面。

回到小唐的故事

小唐最终的代码是这样的:

class User:
   def __init__(self, name, age):
       self.name = name
       self.age = age

   def greet(self):
       return f"Hello, {self.name}"  # 需要实例属性,用 self

   @classmethod
   def from_dict(cls, data):
       return cls(data["name"], data["age"])  # 需要创建实例,用 cls

   @staticmethod
   def is_valid_name(name):
       return bool(name and name.strip())  # 不需要实例也不需要类

greet用self,因为它需要访问self.name。from_dict用cls,因为它要创建实例,并且要支持子类。is_valid_name用@staticmethod,因为它只是一个名字校验工具,和实例、类都无关。

他后来在团队文档里写了一条:“self是实例,cls是类。实例方法用self,类方法用cls。方法类型由装饰器决定,参数名不改变类型。需要创建实例的工厂方法用@classmethod,用cls(...)不要写死类名。既不需要实例也不需要类的工具函数用@staticmethod。不确定就先写实例方法,发现没用self再改。”

self和cls的区别,本质上是“操作对象”和“操作类”的区别。self让你访问某个具体实例的数据,cls让你访问类本身、创建实例、支持继承。用错了不会立即报错,但会在调用方式、继承行为、代码语义上悄悄出问题。

记住那个公司和员工的比喻:self是员工本人,知道自己工号、部门、工资;cls是公司,知道公司名称、规章制度,能招新员工,但不知道某个员工的私人信息。你要操作“某个人”,用self;你要操作“公司这个整体”,用cls。

目录
相关文章
|
5天前
|
Linux Go 开发工具
手机上跑 DeepSeek 智能体:开源安卓客户端 DSH Go 安装与使用指南
DSH Go 是一款开源安卓客户端,将 DeepSeek Harness 智能体引擎装进手机:免 Root、免 Termux,一键安装即用;支持本机运行(内置 Ubuntu+Node.js)或远程接管电脑会话;具备插话打断、过程折叠、屏幕操控、端到端加密分享等特色功能,真正实现智能体“口袋化”。
5922 13
|
5天前
|
弹性计算 人工智能 API
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
建议收藏本教程,2026 全年各版本更新随时回来查阅。如果你在搭建过程中遇到任何问题,欢迎结合 阿里云工单系统 提交技术支持请求,或在 阿里云开发者社区 搜索 Codex 相关话题交流。 祝你编码愉快,效率翻倍!
2186 8
|
8天前
|
人工智能 前端开发 API
阿里云Qwen4-Max 大模型详解:定位、特征、能力、适用场景与相对Qwen3-Max差异解析
2026年11月11日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问AI平台Token Plan并接入千问办公、Qoder等入口。该版本聚焦知识理解、世界感知、编程与Agentic四项升级,主打复杂编程、专业办公、前端设计与专业软件操作等真实任务。预览期为11月11日10:00至11月25日24:00,仅支持Token Plan调用,到期后模型标识下线;限时2折、新用户再享5折,最低1折可体验。
|
8天前
|
JSON 前端开发 API
阿里云最新Qwen4-Max大模型介绍:模型定位、特征、能力、适用场景解析
2026 年 11 月 11 日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问 AI 平台 Token Plan,并同步接入千问办公、Qoder 等入口。该版本聚焦知识理解、世界感知、编程与 Agentic 四项升级,主打复杂编程、专业办公、前端设计与专业软件操作。预览期至 11 月 25 日 24:00,到期后模型标识下线;限时 2 折、新用户再享 5 折,最低 1 折可体验。
|
3天前
|
传感器 安全 区块链
Windows 电脑运行安卓应用教程:开源工具 ApkStart 双击 APK 即装、独立窗口运行
ApkStart 是一款开源Windows工具,让安卓APP像原生软件一样运行:双击APK即安装、生成真实图标、独立窗口启动、开始菜单可搜索。无需传统模拟器,内置QEMU运行时,支持数据互通、ARM兼容与命令行操作。(239字)
|
20天前
|
Linux 开发工具 iOS开发
Codex保姆级教程(下载+安装+登录+使用,含所有版本,2026最新)
Codex是OpenAI推出的开源AI编程智能体,本地运行,可理解整个代码库,支持自然语言指令改代码、执行命令、跑测试、修Bug,兼容Win/macOS/Linux。(239字)
9932 59
|
3天前
|
人工智能 弹性计算 开发工具
零成本玩各大模型!DeepSeek Harness dsh-our-free-model 插件,13 个厂商模型直接用
总结一下:装这个插件,你不用注册、不用绑卡、不用填一个 Key,就能在 DeepSeek Harness 里用上 DeepSeek V4.1 Flash、Kimi K3 这一批前沿模型,而且是白嫖的、还不限量。三步搞定:下载插件,复制包含 `package.json` 的插件目录路径,在「添加插件」里粘贴路径安装并重启。无论是在阿里云 ECS 上通过命令行部署的 Web 版,还是本地的 Electron 桌面端,都能顺利跑通,快速搭建一套零成本的免费模型使用环境。
990 0
|
6天前
|
Linux API iOS开发
【DSH】DeepSeek Harness新手保姆教程(下载+安装+配置+使用,2026最新实测)
DeepSeek Harness(dsh)是DeepSeek AI开源的智能体框架,秉持“一切皆插件”理念,支持读文件、改代码、跑命令、处理表格、联网搜索等操作。免费开源,兼容Windows/macOS/Linux,提供桌面端与网页端,可灵活安装插件扩展能力。
|
15天前
|
Linux 开发工具 iOS开发
2026最新codex下载安装保姆级使用教程(下载+安装+登录+使用,含所有历史版本)
本文详解OpenAI Codex国内快速上手指南:提供Win/macOS/Linux全平台免安装包、npm/Homebrew等多方式安装、账号/API Key双登录、简体中文切换,覆盖下载、安装、汉化、使用及高频避坑(如微软商店失败、npm超时等),10分钟即可跑通。
3376 9