Python类实例化教程:从定义类到创建对象的具体代码写法

花开有时
花开有时
发布时间:2026-11-16| 5人浏览过
原创

本文详细讲解Python中类定义与实例化的完整流程,包括class关键字用法、__init__初始化机制、self参数的本质、带参实例化写法、对象独立命名空间及常见避坑注意事项。

在 Python 中,类(Class)是用于组织数据和逻辑的结构模板,而实例化(Instantiation)则是调用这个类来生成具体对象(Instance)的操作。本文将从最基础的语法结构入手,演示如何定义包含初始化方法的类、如何正确调用类名创建对象并传递参数,同时解析底层生命周期与高频避坑要点。

一、类与实例化的核心机制

理解实例化的关键在于理清“模板”与“实体”的关系。类本身并不占用保存业务数据的内存,它规定了对象将拥有哪些属性(变量)以及具备哪些行为(方法)。当我们像调用函数一样执行 ClassName() 时,Python 解释器就会在内存中为该对象开辟独立的堆内存空间,这个过程就是类实例化。

实例化操作的产物称为“实例”或“对象”。同一个类可以被反复实例化任意多次,每一次实例化得到的都是一个拥有独立内存地址、独立属性值的全新个体。

Python类实例化教程:从定义类到创建对象的具体代码写法
图 1:Python 类模板定义与多次实例化后对象的独立内存分配

二、定义类的基础代码写法与构造机制

在 Python 中定义类使用 class 关键字。按照 PEP 8 命名规范,类名推荐使用大驼峰命名法(如 UserAccount、NetworkDevice)。在类体内部,定义一个实例通常需要声明特殊的初始化方法 __init__。

1. 最简类定义与无参实例化

一个类即使不写任何初始化逻辑,仅包含 pass,也是合法且可以被实例化的:

# 1. 定义最简空类
class EmptyDevice:
    pass

# 2. 实例化创建对象
device_obj = EmptyDevice()

# 3. 验证对象类型与内存标识
print(device_obj)          # 输出示例: <__main__.EmptyDevice object at 0x7f9d8a10>
print(type(device_obj))    # 输出示例: <class '__main__.EmptyDevice'>

在上述代码中,EmptyDevice() 执行了实例化操作,生成了一个具体的对象,并将其引用赋值给变量 device_obj。

2. __init__ 方法与 self 参数的本质

在绝大多数开发场景中,我们需要在创建对象时为它设置初始数据。Python 提供了内置的实例初始化方法 __init__(self, ...)。

  • __init__ 是构造钩子:当类被实例化时,Python 解释器会自动调用该方法对刚刚分配的对象进行初始化设置。
  • self 代表当前实例对象:self 是一个代词。在类定义中,Python 无法预知未来的实例叫什么名字(可能是 user1、user2),因此用 self 指代“正在被创建或正在调用方法的这一个对象”。
  • 属性绑定:通过 self.name = name,我们将传入的参数绑定到当前对象的命名空间中,使其成为该对象的私有属性。
class DatabaseConnector:
    # __init__ 在对象生成后自动被调用
    def __init__(self, host, port, db_name):
        self.host = host          # 将实参绑定到当前实例的 host 属性
        self.port = port          # 绑定 port 属性
        self.db_name = db_name    # 绑定 db_name 属性
        self.is_connected = False # 设定实例的默认状态属性

    def connect(self):
        self.is_connected = True
        return f"已成功连接至 {self.host}:{self.port}/{self.db_name}"

三、从定义到对象的实例化完整执行步骤

类实例化并不是一步完成的黑盒操作。当我们在代码中书写 conn = DatabaseConnector("127.0.0.1", 3306, "main_db") 时,Python 解释器在底层遵循严格的执行管道。

Python类实例化教程:从定义类到创建对象的具体代码写法
图 2:Python 类实例化过程中的生命周期与阶段执行流

具体代码实战:带参数实例化的多种写法

实例化时传递参数的规则,与常规 Python 函数传参完全一致,支持位置参数、关键字参数以及默认缺省参数。

class WorkerTask:
    def __init__(self, task_id, task_name, priority="Normal", retries=3):
        self.task_id = task_id
        self.task_name = task_name
        self.priority = priority
        self.retries = retries

    def get_summary(self):
        return f"[任务 {self.task_id}] {self.task_name} | 优先级: {self.priority} | 重试上限: {self.retries}"

# 方式一:全位置参数实例化
task1 = WorkerTask(1001, "数据清洗")

# 方式二:混合关键字参数实例化(覆盖默认值)
task2 = WorkerTask(1002, "支付结算", priority="High", retries=5)

# 方式三:全关键字传参(参数顺序可自由调换)
task3 = WorkerTask(task_name="发送短信通知", task_id=1003)

# 验证调用输出
print(task1.get_summary())  # 示例: [任务 1001] 数据清洗 | 优先级: Normal | 重试上限: 3
print(task2.get_summary())  # 示例: [任务 1002] 支付结算 | 优先级: High | 重试上限: 5
print(task3.get_summary())  # 示例: [任务 1003] 发送短信通知 | 优先级: Normal | 重试上限: 3
⚠️ 参数对应原则提醒

在定义 def __init__(self, a, b): 时,虽然形参列表有 3 个参数,但在外部实例化 ClassName(1, 2) 时只能传入 2 个参数。第一个 self 参数由 Python 自动填入当前实例,开发者切勿手动传入!

四、深入原理:命名空间隔离与属性查找机制

初学者容易困惑的一个问题是:类属性与实例属性有何不同?当我们通过 obj.attribute 访问一个属性或方法时,Python 是如何定位数据的?

  • 实例属性(Instance Attribute):定义在 __init__ 等方法内部,通过 self.attr = val 声明。它直接存放在该实例的 __dict__ 字典中,每个实例独享一份,修改互不干扰。
  • 类属性(Class Attribute):直接写在 class 缩进块内、方法之外的变量。它属于类对象本身,存放在类的 __dict__ 中,被所有由该类创建的实例共同共享。
Python类实例化教程:从定义类到创建对象的具体代码写法
图 3:Python 实例访问属性与调用方法时的双层命名空间查找机制

我们可以通过代码清晰验证这一隔离与查找逻辑:

class AppConfig:
    system_name = "CloudGateway"  # 类属性(所有实例共享)

    def __init__(self, env):
        self.env = env            # 实例属性(各个实例独占)

app_dev = AppConfig("Dev")
app_prod = AppConfig("Prod")

# 1. 访问类属性:两者读取同一处定义
print(app_dev.system_name)   # 输出: CloudGateway
print(app_prod.system_name)  # 输出: CloudGateway

# 2. 修改实例属性:各自完全独立
print(app_dev.env)   # 输出: Dev
print(app_prod.env)  # 输出: Prod

# 3. 通过实例赋值同名属性:遮蔽(Shadowing)效应
app_dev.system_name = "LocalDevGateway"
print(app_dev.system_name)   # 输出: LocalDevGateway (优先读自身字典)
print(app_prod.system_name)  # 输出: CloudGateway (仍回退读类字典)
print(AppConfig.system_name) # 输出: CloudGateway (类属性未受影响)

五、类实例化过程中的四大高频错误与排查

在编写类定义与创建对象代码时,以下四个报错或逻辑异常最为常见:

1. 缺少圆括号导致的“赋值类本身”而非“实例化”

在 Python 中,类名本身也是一个对象(type 的实例)。如果写成了 obj = MyClass 而没有带括号,变量 obj 仅仅是指向了该类本身,并没有生成任何新对象。

class OrderManager:
    def __init__(self, order_id):
        self.order_id = order_id

# 错误示范:忘记加圆括号
om = OrderManager
print(type(om))  # 输出: <class 'type'>(这是类,不是实例!)
# om.order_id     # 报错: AttributeError: type object 'OrderManager' has no attribute 'order_id'

# 正确写法:务必带上括号并传参
om_real = OrderManager(88902)
print(type(om_real))      # 输出: <class '__main__.OrderManager'>
print(om_real.order_id)   # 输出: 88902

2. TypeError: __init__() takes X positional arguments but Y were given

这个报错通常是因为定义方法时忘记写 self,或者在外部调用时多传了参数。

# 错误定义:忘记声明 self 形参
class BadExample:
    def __init__(name):  # 错误!Python 会把实例当作第一个参数强行塞入 name
        pass

# 调用时:
# obj = BadExample("Tom")
# 报错: TypeError: BadExample.__init__() takes 1 positional argument but 2 were given
# 原因:Python 传入了 2 个参数:<新实例> 和 "Tom",但定义处只留了 1 个位置!

# 正确修复:首个形参始终声明为 self
class GoodExample:
    def __init__(self, name):
        self.name = name

3. __init__() should return None, not '...'

__init__ 仅负责为已经生成的空白实例装配数据,它不允许显式返回任何非 None 的数据。

class Calculator:
    def __init__(self, x, y):
        self.x = x
        self.y = y
        # return x + y  # 错误!实例化处将抛出 TypeError: __init__() should return None

    # 计算结果应当由普通实例方法返回
    def calculate(self):
        return self.x + self.y

calc = Calculator(10, 20)
print(calc.calculate())  # 正常输出: 30

4. 类属性使用可变对象(列表/字典)引发的数据污染陷阱

如果将 list 或 dict 等可变容器直接定义在类体中,所有实例将共享同一个列表对象,导致一个实例追加元素,所有其他实例全部受到波及。

# 危险写法:可变对象作为类属性
class GroupChatWrong:
    members = []  # 共享列表!

# 安全规范写法:在 __init__ 中为每个实例生成独立列表
class GroupChatCorrect:
    def __init__(self):
        self.members = []  # 每次实例化分配独立空列表

chat1 = GroupChatCorrect()
chat2 = GroupChatCorrect()
chat1.members.append("User_A")

print(chat1.members)  # 输出: ['User_A']
print(chat2.members)  # 输出: [] (彼此完全隔离)

六、全流程总结与规范对照

掌握 Python 类定义与对象实例化,核心在于记住三句话:类是代码模版,括号触发创生,self 串联内外。下面通过一张全景图和规范速查清单对整个知识体系进行总结:

Python类实例化教程:从定义类到创建对象的具体代码写法
图 4:Python 面向对象类定义与实例化知识架构与避坑总结
阶段/要素 代码写法示例 底层动作 常见错误
类定义声明 class DeviceManager: 在当前作用域创建 type 类型的类对象 使用带下划线的命名,违反 PEP 8 大驼峰命名规范
构造函数定义 def __init__(self, name): 定义实例初始化挂载函数,绑定 self 漏写首位形参 self,导致外部调用时报形参数量不匹配
创建对象执行 dev = DeviceManager("Switch") 调用 __new__ 分配堆空间并执行 __init__ 赋值 漏写 (),误将类本身的引用赋值给变量
属性访问与调用 dev.name / dev.connect() 沿实例字典向类字典逐层回溯查找并绑定调用 访问不存在的属性名称触发 AttributeError
相关专题:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。