python类里面怎么定义函数方法

一、最基础的定义方式：实例方法与 self 形参

在 Python 中，写在模块顶层的函数称为普通函数，而写在类代码块内部并通过缩进对齐的函数，通常被称为类的方法（Method）。其中最基础、使用频次最高的是实例方法（Instance Method）。

定义一个合法的实例方法，必须满足三个关键要素：

1. 类内缩进：函数定义必须位于 class 类名: 代码块内部，通常向右缩进 4 个空格。
2. def 声明：使用标准的 def 方法名(参数列表): 语法。
3. 显式声明首个形参：形参列表的第一个参数必须预留给实例本身，在 Python 社区中固定书写为 self。

下面是一个完整的定义与调用示例：

# 示例环境：Python 3.8+
class Student:
    # 定义实例方法 say_hello
    def say_hello(self, target_name):
        return f"你好，{target_name}！我是正在学习的同学。"

# 1. 实例化对象
stu = Student()

# 2. 通过对象调用实例方法
greeting = stu.say_hello("李老师")

# 示例输出：
print(greeting)  # 输出: 你好，李老师！我是正在学习的同学。

注意在调用代码 stu.say_hello("李老师") 中，括号内只传入了一个实参 "李老师"，并没有显式传入 self。初学者常在这里产生疑惑：既然定义时写了两个参数 (self, target_name)，为什么调用时只用传一个？

如图 1 所示，当你通过 stu.say_hello("李老师") 触发调用时，Python 解释器在底层会自动将其转化为 Student.say_hello(stu, "李老师")。解释器自动将调用者实例 stu 绑定到了第一个形参 self 上。因此，调用时绝不能手动重复传 self，否则会导致参数数量超标报错。

二、深入辨析 self：它到底是什么，为什么必须显式写出？

在其他面向对象语言（如 Java 或 C++）中，指向当前实例的指针通常由隐式关键字 this 担任，开发者无需在参数列表中写出 this。而在 Python 中，必须显式在形参列表首位写出 self。

1. self 是不是 Python 关键字？

结论：不是。self 只是一个符合 PEP 8 命名规范的通用形参名。在语法层面，即使将其命名为 this、obj 或 me，Python 程序依然能够正常执行。但是，强烈反对使用任何除 self 以外的名称，因为这是全球 Python 开发者通用的代码契约与静态分析工具的默认检查规则。

2. 为什么一定要显式写出 self？

Python 的设计哲学强调“显式优于隐式（Explicit is better than implicit）”。通过在形参中写明 self，在方法体内部通过 self.name 访问实例变量，通过普通变量名 name 访问局部变量，使得变量的作用域边界一目了然，彻底避免了外部同名全局变量与内部实例属性之间产生歧义。

三、类中三种不同方法的定义方式与适用场景

在实际开发中，类里面的函数并非都必须操作具体实例。根据使用场景与参数绑定机制，Python 将类中的方法划分为三类：实例方法、类方法（@classmethod）与静态方法（@staticmethod）。

1. 普通实例方法（Instance Method）

即前文介绍的基础形式，无需任何装饰器，形参首位为 self。它主要用于读取或修改单个对象的专属数据。

2. 类方法（Class Method）

通过在函数上方添加内置装饰器 @classmethod 进行声明。类方法接收的第一个形参不再是实例，而是类本身，通常约定命名为 cls。

适用场景：

• 替代构造函数（工厂方法）：根据不同的入参数据格式（如 JSON、时间戳、文件路径等）构建并返回当前类的实例。
• 操作类级属性：维护属于整个类共享的全局计数器或配置项，不依赖任何特定实例。

class User:
    user_count = 0  # 类属性：全局用户总数

    def __init__(self, username):
        self.username = username
        User.user_count += 1

    # 类方法：作为备用工厂构造器
    @classmethod
    def from_string(cls, info_str):
        name = info_str.strip().split("-")[0]
        # cls(name) 等同于 User(name)，支持子类继承时动态绑定正确类名
        return cls(name)

# 通过类方法直接创建对象
u1 = User.from_string("张三-VIP用户")
print(u1.username)        # 输出: 张三
print(User.user_count)   # 输出: 1

3. 静态方法（Static Method）

通过在函数上方添加内置装饰器 @staticmethod 进行声明。静态方法既不接收 self，也不接收 cls。它本质上就是一个位于类命名空间内部的普通函数，无法隐式访问任何实例或类的状态。

适用场景：某些辅助计算、参数校验或格式化函数，在逻辑上与该类紧密相关，将其放入类中可以提升模块内聚性，便于代码维护与调用。

class MathUtils:
    @staticmethod
    def is_even(number):
        return number % 2 == 0

# 可以通过类名直接调用，无需实例化
print(MathUtils.is_even(10))  # 输出: True
print(MathUtils.is_even(7))   # 输出: False

四、特殊内置方法：以 __init__ 构造函数为例

在 Python 类中，名字以双下划线开头并以双下划线结尾的方法被称为特殊方法（Special Methods）或魔术方法（Magic Methods）。它们会在特定事件触发时由解释器自动调用。

最核心且必须掌握的特殊方法是 __init__，它承担实例被分配后属性初始化的工作。

class BankAccount:
    def __init__(self, owner, initial_balance=0.0):
        # 将入参绑定为实例专属属性
        self.owner = owner
        self.balance = initial_balance

    def deposit(self, amount):
        if amount <= 0:
            raise ValueError("存款金额必须大于零")
        self.balance += amount
        return self.balance

    # 当使用 print() 或 str() 打印对象时自动触发
    def __str__(self):
        return f"账户拥有者: {self.owner}, 余额: {self.balance:.2f}元"

account = BankAccount("王五", 500.0)
account.deposit(200.0)
print(account)  # 输出: 账户拥有者: 王五, 余额: 700.00元

在执行 BankAccount("王五", 500.0) 时，底层经历四个阶段：

1. 内存分配：底层先调用 __new__ 在堆内存中开辟一段新的对象空间。
2. 引用传递：解释器调用 __init__，将新开辟的对象内存地址赋值给形参 self，同时把 "王五" 和 500.0 传给对应参数。
3. 属性赋值：执行 self.owner = owner，在对象的 __dict__ 字典中建立属性映射。
4. 返回交付：__init__ 默认隐式返回 None，外部变量 account 正式获得已完成初始化的实例引用。

五、初学者定义方法最容易踩的 4 个典型错误与排查

编写类内函数时，由于概念混淆或拼写疏忽，常常会引发特定的运行时异常。以下列出四种最典型的问题及修正方案。

1. 定义实例方法时遗漏 self 形参

class Worker:
    def work():  # 错误：未写首位形参 self
        print("正在工作")

w = Worker()
w.work()

2. 方法体内访问属性时忘记写 self 前缀

class Circle:
    def __init__(self, radius):
        self.radius = radius

    def get_area(self):
        return 3.14 * radius * radius  # 错误：直接使用 radius

3. 用类名直接调用未装饰的实例方法

class Report:
    def generate(self):
        return "报表数据"

Report.generate()  # 错误：直接用类名调用实例方法

4. 误将 @staticmethod 的函数写上 self

如果为一个函数加上了 @staticmethod 装饰器，它的首位参数就变成了普通业务参数。如果仍习惯性写了 self，在通过 MyClass.func() 调用时，解释器不会自动传递对象，会导致形参缺失报错。

六、方法类型设计与选型决策指南

在面向对象设计中，一个函数到底应该定义为普通实例方法、类方法、静态方法，还是直接写在类外面作为模块普通函数？可以依照下面的决策图进行判断：

总结对照清单

掌握以上三种方法的定义语法、参数流动机制以及 self 的绑定原理，就能在 Python 面向对象编程中游刃有余地组织代码结构，写出规范、健壮且易于维护的方法逻辑。