使用@property装饰器时，属性名是否真的要以下划线开头？

我知道Python中约定，不应直接访问的属性名要以下划线开头。但在使用@property装饰器定义getter和setter时，发现遵循这一约定存在弊端：

问题示例1：遵循下划线约定，但初始化不调用setter #

class TestClass:
    def __init__(self, test_param):
        self._test_attr = test_param

    @property
    def test_attr(self):
        return self._test_attr
    
    @test_attr.setter
    def test_attr(self, value):
        self._test_attr = value.upper()

test_instance = TestClass("foo")
print(test_instance.test_attr)  # 输出foo，而非预期的FOO

初始化阶段直接赋值给_test_attr，不会触发setter的大写转换逻辑，导致属性处理逻辑不一致。

问题示例2：打破下划线约定，可读性降低 #

class TestClass:
    def __init__(self, test_param):
        self.test_attr = test_param

    @property
    def test_attr(self):
        return self._test_attr
    
    @test_attr.setter
    def test_attr(self, value):
        self._test_attr = value.upper()

test_instance = TestClass("foo")
print(test_instance.test_attr)  # 输出FOO

初始化时调用了setter，逻辑一致，但其他开发者无法通过下划线识别_test_attr是内部非公开属性，可读性变差。

通用实践与两全其美的解决方案 #

1. 在__init__中直接调用公开属性的setter

这是最常用的方案，既遵守下划线约定，又保证所有属性赋值（包括初始化）都走统一逻辑：

class TestClass:
    def __init__(self, test_param):
        self.test_attr = test_param  # 直接调用公开属性的setter，而非操作_test_attr

    @property
    def test_attr(self):
        return self._test_attr
    
    @test_attr.setter
    def test_attr(self, value):
        self._test_attr = value.upper()

test_instance = TestClass("foo")
print(test_instance.test_attr)  # 输出FOO

这样_test_attr明确标记为内部属性，公开接口是test_attr，初始化和后续赋值都经过setter处理，逻辑完全一致。

2. 用文档字符串补充说明（增强可读性）

如果担心其他开发者混淆，可以在类的文档字符串中明确标注公开接口和内部实现：

class TestClass:
    """
    示例类，提供test_attr公开属性，自动将输入转换为大写存储
    注意：_test_attr是内部实现细节，请勿直接访问或修改
    """
    def __init__(self, test_param):
        self.test_attr = test_param

    @property
    def test_attr(self):
        return self._test_attr
    
    @test_attr.setter
    def test_attr(self, value):
        self._test_attr = value.upper()

文档说明加上后，既能遵守下划线约定，又能清晰传达代码意图。

3. 抽离公共处理逻辑（复杂场景适用）

如果属性的处理逻辑复杂，避免重复代码，可以把逻辑抽成私有方法，在__init__和setter中统一调用：

class TestClass:
    def __init__(self, test_param):
        self._process_test_attr(test_param)

    def _process_test_attr(self, value):
        # 这里可以添加更多复杂的验证或转换逻辑
        self._test_attr = value.upper()

    @property
    def test_attr(self):
        return self._test_attr
    
    @test_attr.setter
    def test_attr(self, value):
        self._process_test_attr(value)

这种方式适合逻辑复杂的场景，既保证了代码复用，又清晰区分了内部实现和公开接口。

核心原则 #

Python的下划线属性约定是提示性的，而非强制性的，核心目标是区分「公开接口」和「内部实现细节」。只要保证对外暴露的是test_attr这个公开属性，内部用_test_attr存储，同时让所有属性赋值都经过统一的处理逻辑，就能兼顾约定、功能和可读性。

内容的提问来源于stack exchange，提问作者Butters