本文将指导您如何使用Python面向对象编程构建灵活的类结构，以处理具有可变数量子属性的场景。通过将主实体（如站点）和其子属性（如校区）分别定义为独立类，并利用主类中的列表引用子类实例，可以优雅地解决在不同情境下子属性数量不一致的问题。这种设计模式提高了代码的可维护性和扩展性，避免了硬编码和冗余属性。
在软件开发中，我们经常需要为实体建模，而这些实体可能包含数量不固定的子组件或相关属性。例如，一个公司站点可能有一个或多个校区，而每个校区又拥有自己的特定信息。直接在主类中为每个可能的子属性预留字段（如 XCampusName、XCampusApprover）会导致类结构臃肿、难以管理，尤其当子属性数量变化时，代码维护成本极高。这种方法不仅引入了大量冗余属性，也使得处理不存在的子属性时逻辑复杂。
为了优雅地解决这一问题，Python面向对象编程提供了一种强大的模式：对象组合（Object Composition）。通过将主实体和其子属性分别定义为独立的类，并在主类中通过引用（通常是列表）来“拥有”子属性类的实例，我们可以实现高度灵活和可扩展的设计。
1. 定义子属性类
首先，我们需要为子属性（在本例中是“校区”）创建一个独立的类。这个类将封装校区的所有相关信息。
立即学习“Python免费学习笔记（深入）”；
class Campus:
"""
表示一个校区及其相关信息。
"""
def __init__(self, name: str, approver: str):
"""
初始化一个Campus实例。
:param name: 校区名称。
:param approver: 校区设备退回审批人。
"""
self.name = name
self.approver = approver
def __str__(self):
"""
返回校区的字符串表示，便于打印。
"""
return self.name
def __repr__(self):
"""
返回校区的官方字符串表示，便于调试。
"""
return f"Campus(name='{self.name}', approver='{self.approver}')"Campus 类简洁明了，只包含校区特有的属性。__str__ 和 __repr__ 方法的加入，使得对象在打印或调试时能提供更友好的信息。
2. 构建主实体类
接下来，我们定义主实体类（在本例中是“站点”）。这个类将包含站点的核心属性，并引入一个列表来管理其关联的 Campus 对象。
class Site:
"""
表示一个站点及其配置信息，可包含多个校区。
"""
def __init__(self, name: str, site_id: str, key: str, url: str,
collection_name: str, approval_name: str):
"""
初始化一个Site实例。
:param name: 站点名称。
:param site_id: 站点ID。
:param key: 帮助台API Key。
:param url: 帮助台URL。
:param collection_name: 帮助台中的收集状态名称。
:param approval_name: 帮助台中的审批状态名称。
"""
self.name = name
self.site_id = site_id
self.key = key
self.url = url
self.collection_name = collection_name
self.approval_name = approval_name
self.campuses = [] # 使用列表存储关联的Campus对象
def add_campus(self, campus: Campus):
"""
向当前站点添加一个校区。
:param campus: 要添加的Campus实例。
"""
if not isinstance(campus, Campus):
raise TypeError("Expected a Campus instance.")
self.campuses.append(campus)
def get_campuses_count(self) -> int:
"""
获取当前站点关联的校区数量。
:return: 校区数量。
"""
return len(self.campuses)
def get_campus_by_name(self, name: str) -> Campus | None:
"""
根据名称查找并返回一个校区。
:param name: 校区名称。
:return: 匹配的Campus实例，如果未找到则返回None。
"""
for campus in self.campuses:
if campus.name == name:
return campus
return None
def __repr__(self):
"""
返回站点的官方字符串表示。
"""
return (f"Site(name='{self.name}', site_id='{self.site_id}', "
f"campuses_count={self.get_campuses_count()})")在 Site 类中，最关键的是 self.campuses = [] 这一行。它初始化了一个空列表，用于存储该站点下所有的 Campus 对象。add_campus 方法提供了一种类型安全的方式来添加校区，而 get_campuses_count 和 get_campus_by_name 则是方便访问和管理校区的方法。
3. 实例化与关联
现在，我们可以创建 Site 和 Campus 的实例，并将校区关联到相应的站点。
# 创建一个Site实例
site1 = Site(
name="总部",
site_id="HQ001",
key="ABCDEFG12345",
url="https://helpdesk.example.com/hq",
collection_name="待收集",
approval_name="待审批"
)
# 创建Campus实例
campus_main = Campus("主校区", "张三")
campus_north = Campus("北区校区", "李四")
# 将校区添加到站点
site1.add_campus(campus_main)
site1.add_campus(campus_north)
# 验证和访问数据
print(f"站点名称: {site1.name}")
print(f"站点ID: {site1.site_id}")
print(f"关联校区数量: {site1.get_campuses_count()}")
print("\n--- 站点 '总部' 的校区信息 ---")
for i, campus in enumerate(site1.campuses):
print(f" 校区 {i+1}: 名称='{campus.name}', 审批人='{campus.approver}'")
# 访问特定校区
main_campus = site1.get_campus_by_name("主校区")
if main_campus:
print(f"\n找到 '主校区'，审批人是: {main_campus.approver}")
# 创建一个没有校区的站点
site2 = Site(
name="分部A",
site_id="BR001",
key="HIJKLMN67890",
url="https://helpdesk.example.com/bra",
collection_name="待回收",
approval_name="待确认"
)
print(f"\n站点 '{site2.name}' 关联校区数量: {site2.get_campuses_count()}") # 将输出 0通过上述示例，我们可以清晰地看到，Site 类现在可以灵活地包含任意数量的 Campus 对象，甚至不包含任何校区。这种设计模式完美解决了原始问题中“不加载不存在的信息”的需求。
优势与注意事项
优势：
- 灵活性与可扩展性： 站点可以拥有零个、一个或多个校区，无需修改 Site 类的定义。未来如果需要添加更多校区，只需创建新的 Campus 实例并添加到 campuses 列表中即可。
- 代码清晰与维护性： 每个类职责单一，Site 负责管理站点自身信息和其关联的校区集合，Campus 负责管理校区自身的属性。这使得代码更易于理解、测试和维护。
- 避免冗余： 不会为不存在的校区预留属性，从而避免了内存浪费和属性名冲突的风险。
- 真实世界建模：
