Python类的基础定义与实例化调用方法

一、Python 类的基础定义与核心要素

定义一个类需要使用关键字 class，其后跟随类名和冒号。按照PEP 8官方编码规范，类名通常采用帕斯卡命名法（PascalCase，即首字母大写的驼峰命名）。在类定义的代码块中，通常包含两大核心要素：属性（存储数据）与方法（执行逻辑）。

1. 构造方法 __init__ 与参数传递

__init__ 是Python内置的特殊实例方法（双下划线方法，又称魔法方法）。当类被用于创建新对象时，Python会自动调用该方法为新对象初始化属性状态。如果不定义 __init__，Python会默认提供一个无操作的初始化过程。

2. self 关键字的作用机制

在类内部定义的所有实例方法中，第一个参数都约定必须命名为 self。self 本质上是当前被创建或正在操作的实例对象本身的引用。在 __init__ 内部，通过 self.name = name 的形式，将外部传入的参数绑定到当前具体的实例对象上，从而成为该实例的独享属性。

图 1 展示了 Python 类定义的基本语句要素，包括类名声明、构造函数与实例方法的对应关系。

二、类的实例化与内存对象分配

定义类之后，它仅仅是一份存放在内存中的代码模具。要真正投入使用，必须通过实例化操作生成具体的对象。

1. 实例化基本语法

实例化的语法非常直观：直接将类名作为函数来调用，并在括号中传入 __init__ 方法除 self 之外所需的实参：

# 实例化两个完全独立的对象
user1 = UserProfile("张小明", "管理员")
user2 = UserProfile("李四", "普通用户")

2. 底层执行机制与内存映射

当执行 user1 = UserProfile("张小明", "管理员") 时，Python 解释器在底层自动执行两个核心动作：

1. 分配内存空间：调用内置的 __new__ 方法在堆内存中为新对象分配一块独占空间，生成一个空对象引用。
2. 执行属性初始化：将该对象的引用隐式作为第一个参数传入并执行 __init__(user1, "张小明", "管理员")，将数据属性写入对象内部字典 __dict__ 中。

尽管 user1 和 user2 共享同一份来自 UserProfile 的方法逻辑，但两者的状态数据是彼此隔离的。

图 2 说明了实例化创建过程：模板只保存一份方法逻辑，每个实例独立占用堆内存存储属性。

三、属性访问与方法调用的具体方式

创建实例后，我们通过英文句点（.）操作符来访问实例的属性和调用实例的方法。

1. 属性的读取与修改

Python 中的属性具有动态特性。可以直接通过 对象名.属性名 进行读取或覆写：

# 读取实例属性
print(user1.username)  # 示例输出: 张小明

# 直接修改实例属性
user1.role = "超级管理员"
print(user1.role)      # 示例输出: 超级管理员

2. 方法调用的本质：隐式 self 传参

当执行 user1.get_badge() 时，虽然我们在括号中没有传任何实参，但 Python 解释器会自动将其转换为：

# 两种写法在运行时完全等价：
result_a = user1.get_badge()
result_b = UserProfile.get_badge(user1)

这正是 self 的核心价值所在：它充当了实例与类方法之间的桥梁，使方法能够准确定位并操作发起调用的具体实例。

图 3 梳理了从编写类代码到实例化对象、读写属性和方法调用的完整闭环流程。

四、完整实战示例：银行账户管理类

为了直观展示定义、实例化及方法调用的完整生命周期，下面编写一个管理银行账户资金的完整Python脚本。本示例涵盖带参数的初始化方法、状态检查逻辑、资金存取及打印格式化信息。

class BankAccount:
    """银行账户管理类：封装账户名称、余额以及基本的存取款逻辑"""
    
    def __init__(self, owner: str, initial_balance: float = 0.0):
        # 实例属性初始化
        self.owner = owner
        self.balance = float(initial_balance)
        self.transaction_history = []

    def deposit(self, amount: float) -> str:
        """存款方法：增加余额并记录明细"""
        if amount <= 0:
            return "存款金额必须大于零"
        self.balance += amount
        self.transaction_history.append(f"+{amount}")
        return f"已成功存入 {amount} 元，当前余额：{self.balance} 元"

    def withdraw(self, amount: float) -> str:
        """取款方法：校验余额是否充足并执行扣减"""
        if amount <= 0:
            return "取款金额必须大于零"
        if amount > self.balance:
            return f"余额不足！当前可用余额仅为 {self.balance} 元"
        self.balance -= amount
        self.transaction_history.append(f"-{amount}")
        return f"成功取出 {amount} 元，剩余余额：{self.balance} 元"

    def get_summary(self) -> str:
        """打印账户汇总报表"""
        history_str = ", ".join(self.transaction_history) if self.transaction_history else "无记录"
        return f"【账户持有者: {self.owner} | 余额: {self.balance} 元 | 流水: {history_str}】"


# ---------------- 实例化与调用演示 ----------------

# 1. 实例化两个账户
account_a = BankAccount("张三", 1000.0)
account_b = BankAccount("李四", 50.0)

# 2. 调用 account_a 的存取款方法
print(account_a.deposit(500.0))    # 示例输出: 已成功存入 500.0 元，当前余额：1500.0 元
print(account_a.withdraw(200.0))   # 示例输出: 成功取出 200.0 元，剩余余额：1300.0 元

# 3. 调用 account_b 的超额取款方法（触发业务校验）
print(account_b.withdraw(100.0))   # 示例输出: 余额不足！当前可用余额仅为 50.0 元

# 4. 获取两者的独立汇总状态
print(account_a.get_summary())     # 示例输出: 【账户持有者: 张三 | 余额: 1300.0 元 | 流水: +500.0, -200.0】
print(account_b.get_summary())     # 示例输出: 【账户持有者: 李四 | 余额: 50.0 元 | 流水: 无记录】

五、新手高频混淆点与排查指引

初学者在定义与调用类时，往往会遇到一些典型错误。下表整理了高频报错原因及正确的解决方式：

六、核心要点总结

掌握 Python 类的核心在于理清“模板”与“实体”的对应关系：类是只定义一次的代码规范，实例化则是将规范落地为具体内存对象的过程。牢记 self 扮演的实例指代角色，便能自如处理属性读写与行为触发。

图 4 总结了类定义、实例化、self 传参机制与常见注意要点，便于快速复习查阅。