#Python 类属性封装与访问控制教程

class Student:
    def __init__(self, name):
        self.name = name  # 公共属性：直接裸奔

# 外部直接读写
s = Student("Alice")
print(s.name)  # 输出 Alice
s.name = "Bob" # 直接改掉也没问题

class Student:
    def __init__(self, name):
        self._name = name  # 受保护属性：加了个“请勿打扰”的门帘

s = Student("Alice")
print(s._name)  # 输出 Alice，但不建议这么写

class Student:
    def __init__(self, name):
        self.__name = name  # 私有属性：上了个“假锁”

s = Student("Alice")
# print(s.__name)  # 直接报错：AttributeError: 'Student' object has no attribute '__name'

class Student:
    def __init__(self, name, score):
        self.__name = name    # 私有姓名（只读比较合理，入学后一般不能改）
        self.__score = score  # 私有分数（可读写，但必须验证）
    
    # 姓名的 getter（不提供 setter）
    def get_name(self):
        return self.__name
    
    # 分数的 getter
    def get_score(self):
        return self.__score
    
    # 分数的 setter（加了 0-100 的验证）
    def set_score(self, score):
        if not isinstance(score, (int, float)):
            raise TypeError("分数必须是数字")
        if 0 <= score <= 100:
            self.__score = score
        else:
            raise ValueError("分数必须在 0-100 之间")

class Student:
    def __init__(self, name, score):
        self.__name = name
        self.__score = score
    
    # 只读属性：只加 @property，不加 @xxx.setter
    @property
    def name(self):
        """学生姓名（只读）"""
        return self.__name
    
    # 可读可写属性：先加 @property 定义 getter，再加 @xxx.setter 定义 setter
    @property
    def score(self):
        """学生分数（0-100）"""
        return self.__score
    
    @score.setter  # 注意格式：必须和 getter 的方法名完全一致
    def score(self, value):
        if not isinstance(value, (int, float)):
            raise TypeError("分数必须是数字")
        if 0 <= value <= 100:
            self.__score = value
        else:
            raise ValueError("分数必须在 0-100 之间")

s = Student("Bob", 85)
print(s.name)    # 输出 Bob，像访问公共属性一样
# s.name = "Charlie"  # 直接报错：AttributeError: can't set attribute（因为没加 setter）
s.score = 90     # 输出 90，像赋值公共属性一样
# s.score = -5   # 报错：ValueError: 分数必须在 0-100 之间

class Student:
    def __init__(self, name):
        self.__name = name

s = Student("Alice")
print(dir(s))  # 会看到很多内置属性，其中有个 '_Student__name'
print(s._Student__name)  # 输出 Alice！但千万不要在生产代码里这么写

class Student:
    def __init__(self):
        self.__special_attr__ = "这是特殊属性"

s = Student()
print(s.__special_attr__)  # 直接输出：这是特殊属性

class Student:
    def __init__(self, name, gender):
        self.__name = name
        self.__gender = None  # 先设为 None，用 setter 初始化（复用验证逻辑）
        self.gender = gender  # 调用下面的 setter
    
    @property
    def gender(self):
        return self.__gender
    
    @gender.setter
    def gender(self, value):
        if value not in ('male', 'female'):
            raise ValueError("性别必须是 'male' 或 'female'")
        self.__gender = value

# 测试代码
if __name__ == "__main__":
    try:
        bart = Student('Bart', 'male')
        assert bart.gender == 'male', "初始性别设置失败"
        bart.gender = 'female'
        assert bart.gender == 'female', "修改性别设置失败"
        # 测试非法值
        # bart.gender = 'unknown'  # 应该报错
        print("✅ 测试成功！")
    except Exception as e:
        print(f"❌ 测试失败：{e}")