在类初始化时，无法直接在 f-string 中引用 self 或实例属性（如 {self.utility}），因为 f-string 在定义时即求值，而此时 self 尚未绑定；正确做法是使用延迟格式化的 .format() 方法配合模板字符串。

在类初始化时，无法直接在 f-string 中引用 `self` 或实例属性（如 `{self.utility}`），因为 f-string 在定义时即求值，而此时 `self` 尘未绑定；正确做法是使用延迟格式化的 `.format()` 方法配合模板字符串。

在 Python 中，f-string（如 f"Restores {self.utility} hp"）是在字符串字面量被解析时立即执行求值的表达式。而类实例的 self 仅在 __init__ 方法内部才存在，且 f-string 若写在类定义外部（如传入 description= 参数的位置），根本无法访问 self——这正是报错 NameError: name 'self' is not defined 的根本原因。

要实现“用一个属性动态填充另一属性的描述文本”，核心思路是：将描述设计为可延迟格式化的模板字符串，待 self 创建完成后再执行替换。以下是三种推荐实践方式：

Python 3.14.2

Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。

下载

✅ 方案一：显式传入 self（清晰、可控）

class ShopItem:
    def __init__(self, name='<unnamed>', price=0.00, utility=0, description="<undefined>"):
        self.name = name
        self.price = price
        self.utility = utility
        # 使用 .format() 延迟求值，通过 self=self 提供上下文
        self.description = description.format(self=self)

# 模板中使用 {self.xxx} 语法
apple = ShopItem(
    "Apple",
    1.2,
    2,
    "A delicious apple.\nRestores {self.utility} hp"
)
print(apple.description)
# 输出：
# A delicious apple.
# Restores 2 hp</undefined></unnamed>

✅ 方案二：用 vars(self) 自动展开所有实例属性（简洁、灵活）

class ShopItem:
    def __init__(self, name='<unnamed>', price=0.00, utility=0, description="<undefined>"):
        self.name = name
        self.price = price
        self.utility = utility
        # vars(self) 返回 {'name': ..., 'price': ..., 'utility': ...}
        self.description = description.format(**vars(self))

apple = ShopItem(
    "Apple",
    1.2,
    2,
    "A delicious apple.\nRestores {utility} hp"  # 直接用属性名，无需 self.
)</undefined></unnamed>

✅ 方案三：按需传入关键变量（安全、明确）

class ShopItem:
    def __init__(self, name='<unnamed>', price=0.00, utility=0, description="<undefined>"):
        self.name = name
        self.price = price
        self.utility = utility
        # 只传递真正需要的变量，避免命名冲突或意外覆盖
        self.description = description.format(utility=utility, name=name)

apple = ShopItem(
    "Apple",
    1.2,
    2,
    "A {name}.\nRestores {utility} hp"
)</undefined></unnamed>

⚠️ 重要注意事项：

• 所有上述方案均在 __init__ 中一次性完成格式化，生成的是固定字符串。若后续修改 apple.utility = 5，apple.description 不会自动更新——它已是一个普通 str 对象。如需实时响应属性变化，应改用 @property 动态计算：

  @property
  def description(self):
      return f"A delicious {self.name}.\nRestores {self.utility} hp"

• 避免在模板中使用未定义的属性名（如 {missing_attr}），否则会触发 KeyError；方案二中若 vars(self) 不含该键，同样报错。

综上，f-string 不适用于类初始化阶段的跨属性引用；采用 .format() + 模板字符串是兼顾可读性、灵活性与安全性的标准解法。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！