在 python 中，`@property` 的公开名称（如 `name`）应不带下划线，而其背后存储数据的私有实例属性（如 `_name`）必须加单下划线前缀——这是有意为之的设计模式，旨在清晰分离接口与实现，并确保逻辑复用与一致性。
在定义带属性控制的类时，正确区分 name（属性名）和 _name（底层存储名）至关重要。前者是用户可见、可读写的公共接口；后者是仅供 getter/setter 内部使用的“受保护”实例属性，遵循 Python 的命名约定（单下划线表示“非公开”，即内部实现细节）。
例如，以下写法是推荐且正确的：
class Employee:
def __init__(self, name, birth_date, start_date):
self.name = name # ✅ 调用 property setter，统一处理逻辑
self.birth_date = birth_date
self.start_date = start_date
@property
def name(self):
return self._name # ✅ 读取私有存储
@name.setter
def name(self, value):
self._name = value.upper() # ✅ 写入前标准化（如转大写）注意：__init__ 中赋值 self.name = name 并非绕过逻辑，而是主动利用 property 机制——它会自动触发 @name.setter，从而保证所有赋值（无论来自初始化、外部调用或后续修改）都经过同一套验证/转换逻辑。若在 __init__ 中直接写 self._name = name.upper()，虽能运行，但会导致业务逻辑（如大小写转换）重复出现，违反 DRY（Don’t Repeat Yourself）原则，也增加维护风险。
此外，这种分离还带来关键优势：
立即学习“Python免费学习笔记（深入）”；
- 封装性增强：外部无法直接访问 _name，避免绕过约束；
- 可扩展性强：未来可在 setter 中轻松添加日志、校验、缓存等逻辑，无需修改初始化代码；
- 符合描述符协议本质：property 是一个描述符对象，绑定到类属性 name 上；每次 obj.name 访问实际由描述符的 __get__ 和 __set__ 方法接管，而 obj._name 始终只是普通实例数据。
⚠️ 注意事项：
- 不要将 _name 视为“类的私有字段”，而应视为 name 属性的私有实现载体；
- 避免在类的其他方法中直接读写 _name（除非极特殊场景），优先通过 self.name 访问以保持一致性；
- 若需真正私有（不可被子类意外覆盖），可用双下划线 __name（触发名称改写），但通常单下划线已足够表达设计意图。
总之，name（无下划线）是契约，_name（带下划线）是实现——这一命名惯例不是语法要求，而是 Python 社区广泛采纳的工程实践，体现了清晰的接口抽象与稳健的代码演化能力。
