本文详解 Python 类内方法相互调用时出现 NameError: name 'function1' is not defined 的根本原因，指出类定义语法错误、缺失 self 参数、未实例化对象三大关键问题，并提供可运行的修正代码与最佳实践。
本文详解 python 类内方法相互调用时出现 `nameerror: name 'function1' is not defined` 的根本原因，指出类定义语法错误、缺失 `self` 参数、未实例化对象三大关键问题，并提供可运行的修正代码与最佳实践。
在 Python 中，当尝试在一个类的方法内部直接调用另一个同级方法（如 function2 中调用 function1）却未正确使用实例引用时，解释器会抛出 NameError: name 'function1' is not defined。这并非变量作用域问题，而是源于对 Python 类机制的误解——类内部的方法不是全局函数，不能脱离实例上下文直接调用。
? 核心错误分析
原始代码存在三处典型错误：
- 错误的类定义语法：class.class1(): 是非法语法，Python 中类定义应为 class ClassName:；
- 缺失 self 参数：类方法必须将第一个参数声明为 self，以接收调用该方法的实例对象；否则方法无法被绑定到实例，也无法通过 self 访问同类其他方法；
- 未创建实例即调用方法：class1.function2(...) 是以类名直接调用实例方法，此时 self 无实际指向，导致 TypeError；必须先实例化（如 c1 = class1()），再通过实例调用。
✅ 正确写法（完整可运行示例）
num1 = 123
num2 = 1234
class Class1: # 类名建议使用 PascalCase
def function1(self, a, b): # self 是必需的第一参数
return a + b
def function2(self, x, y):
result = self.function1(x, y) # ✅ 通过 self 调用同实例的其他方法
print(f"Sum: {result}")
# ✅ 必须先实例化，再调用
instance = Class1()
instance.function2(num1, num2) # 输出：Sum: 1357? 提示：self.function1(...) 中的 self. 明确告诉 Python —— “请在当前实例的作用域中查找 function1 方法”，而非在局部或全局作用域搜索，从而避免 NameError。
⚠️ 常见误区与注意事项
- ❌ 不要写 function1(x, y)（缺少 self.）→ 触发 NameError
- ❌ 不要写 Class1.function2(num1, num2)（类直接调用实例方法）→ 触发 TypeError: missing 1 required positional argument: 'y'
- ✅ 若需不依赖实例的方法，应明确定义为 @staticmethod 或 @classmethod，但此时无法访问实例属性或其它实例方法；
- ✅ 方法参数命名建议避免与外部变量同名（如原代码中 num1, num2），推荐使用更具语义的名称（如 a, b, x, y），提升可读性与可维护性。
? 总结
NameError: name 'xxx' is not defined 在类方法调用场景中，本质是作用域与绑定机制的认知偏差。牢记三点：
① 类定义用 class Name:；
② 实例方法首参必为 self；
③ 调用必须通过实例（obj.method()），且同类方法间调用需加 self. 前缀。
掌握这些原则，即可彻底规避此类错误，并写出结构清晰、符合 Python 惯例的面向对象代码。
