Python类属性与实例详解

本文深入剖析了Python中实例属性与类属性的区别，并通过一个纸牌游戏实例，揭示了因错误使用实例属性导致数据隔离的问题。**Python实例属性**和**类属性**是理解Python面向对象编程的关键。文章详细分析了将共享数据误定义为实例属性时，各个对象拥有独立数据副本，无法实现数据共享的现象。针对此问题，提出了两种解决方案：一是将牌堆定义为**类属性**，实现所有实例共享同一份数据；二是采用依赖注入模式，显式传递共享的牌堆对象。通过对比分析，旨在帮助开发者在实际项目中正确选择和使用Python的属性类型，避免数据隔离问题，从而提升代码的可维护性和可读性。理解**Python属性类型**，掌握**类属性共享**技巧，对于编写高质量的Python代码至关重要。

本文深入探讨了Python中实例属性与类属性在继承和共享数据场景下的关键区别。通过一个纸牌游戏案例，我们分析了因误将共享数据定义为实例属性而导致的数据隔离问题，并提供了两种有效的解决方案：一是利用类属性实现数据的全局共享，二是采用依赖注入模式传递共享对象，旨在帮助开发者正确管理类间共享状态，提升代码的清晰度和可维护性。

理解Python中的属性类型：实例属性与类属性

在Python中，类和对象可以拥有不同类型的属性，其中最常见的是实例属性和类属性。理解它们的区别对于正确管理数据共享至关重要。

• 实例属性 (Instance Attributes)：

  • 通过 self.attribute_name 在 __init__ 方法中定义或在实例方法中动态创建。
  • 每个类的实例都拥有自己独立的一份实例属性。
  • 修改一个实例的实例属性不会影响其他实例的同名属性。
  • 它们通常用于存储每个对象特有的状态。

• 类属性 (Class Attributes)：

  • 直接在类定义内部、方法外部声明。
  • 所有类的实例共享同一份类属性。
  • 通过 ClassName.attribute_name 或 self.attribute_name (当实例本身没有同名实例属性时) 访问。
  • 如果通过实例修改一个可变类属性（如列表、字典），所有其他实例都会看到这个修改，因为它们引用的是同一个对象。如果通过实例赋值一个不可变类属性，实际上会创建一个同名的实例属性，从而“遮蔽”类属性。
  • 它们通常用于存储所有实例共享的数据、常量或默认值。

原问题分析：为什么牌堆没有共享？

考虑以下纸牌游戏的初始代码：

from random import choice

class PlayingCards:
    suits = ['Diamond','Club','Heart','Spade']
    numbers = [x for x in range(2,11)] + list('JQKA')
    def __init__(self):
        # main_deck 被定义为实例属性
        self.main_deck = [[number,suit] for number in self.numbers for suit in self.suits]
        self.drawed_card = []
        self.drawn_cards = []

    def hit(self):
        if self.main_deck:
            self.drawed_card = self.main_deck.pop(choice(range(len(self.main_deck))))
            self.drawn_cards.append(self.drawed_card)
            return self.drawed_card
        else:
            return None

class PlayerHand(PlayingCards):

    def __init__(self):
        super().__init__() # 调用父类的 __init__，再次创建了 self.main_deck
        self.player_drawn_cards = []

    def hit(self):
        if self.main_deck: # 访问的是当前实例的 main_deck
            self.drawed_card = self.main_deck.pop(choice(range(len(self.main_deck))))
            self.player_drawn_cards.append(self.drawed_card)
            return self.drawed_card
        else:
            return None

# 实例化两个对象
cards = PlayingCards()
player1_cards = PlayerHand()

# 执行抽牌操作
cards.hit()
print(len(cards.main_deck)) # 期望 51，实际输出 51

player1_cards.hit()
print(len(cards.main_deck)) # 期望 50，实际输出 51

代码的输出结果 51 和 51 表明，尽管 hit() 方法被调用了两次，但 cards.main_deck 的长度只减少了一次。这是因为在 PlayingCards 类的 __init__ 方法中，self.main_deck 被定义为一个实例属性。

当执行 cards = PlayingCards() 时，cards 实例创建了自己的 main_deck。 当执行 player1_cards = PlayerHand() 时，由于 PlayerHand 继承自 PlayingCards 并调用了 super().__init__()，player1_cards 实例也创建了自己独立的 main_deck。

因此，cards.main_deck 和 player1_cards.main_deck 是两个完全独立的牌堆。cards.hit() 操作的是 cards 自己的牌堆，而 player1_cards.hit() 操作的是 player1_cards 自己的牌堆。它们之间没有共享关系，导致 cards.main_deck 的长度只受 cards.hit() 调用的影响。

为了实现所有玩家从同一个共享牌堆中抽牌，我们需要确保 main_deck 是一个所有实例都能访问并修改的共享资源。

解决方案一：利用类属性实现共享牌堆

一种解决方案是将 main_deck 定义为 PlayingCards 类的类属性。这样，所有 PlayingCards 及其子类的实例都将共享同一个 main_deck 对象。

import random

class PlayingCardsSolution1:
    suits = ['Diamond','Club','Heart','Spade']
    numbers = [x for x in range(2,11)] + list('JQKA')

    # 将 main_deck 定义为类属性，所有实例共享此牌堆
    _full_deck_template = [[number,suit] for number in numbers for suit in suits]
    main_deck = list(_full_deck_template) # 初始化的共享牌堆

    def __init__(self):
        # 实例属性用于存储当前实例抽到的牌，不再创建独立的 main_deck
        self.drawn_cards = []

    def hit(self):
        if PlayingCardsSolution1.main_deck: # 从类共享牌堆中抽牌
            chosen_index = random.choice(range(len(PlayingCardsSolution1.main_deck)))
            card = PlayingCardsSolution1.main_deck.pop(chosen_index)
            self.drawn_cards.append(

今天关于《Python类属性与实例详解》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！