0

0

Python中类变量与实例变量的唯一性管理:理解描述符协议与实例属性的最佳实践

碧海醫心

碧海醫心

发布时间:2025-10-31 13:08:00

|

262人浏览过

|

来源于php中文网

原创

Python中类变量与实例变量的唯一性管理:理解描述符协议与实例属性的最佳实践

本文深入探讨python中类变量和实例变量的唯一性问题,特别是在`qobject`和`signal`的上下文。通过分析`signal`的实例绑定行为与普通类属性的共享行为差异,揭示了python描述符协议的作用。文章强调,若需确保每个实例拥有独立的属性对象,最pythonic且推荐的做法是在类的`__init__`方法中进行初始化,而非将其定义为类属性。

引言:类属性的共享行为与特殊案例

在Python中,当我们在类定义内部声明一个变量时,它通常被称为类属性。类属性默认由该类的所有实例共享。然而,某些特殊类型的类属性,如PySide2.QtCore.Signal,表现出与普通类属性不同的行为,它们似乎为每个实例提供了唯一的对象。

考虑以下示例代码:

from PySide2.QtCore import QObject, Signal

class MyClass:
    pass

class PSClass(QObject):
    onRequest = Signal(str)
    onMySignal = MyClass() # 这是一个普通的类属性

    def __init__(self):
        super().__init__()
        self.onRequest.connect(self.printSomething)

    def send(self, message:str):
        self.onRequest.emit(message)

    def printSomething(self, data:str):
        print(data)

sample_01 = PSClass()
sample_02 = PSClass()

sample_01.send(f"Signal ID:{id(sample_01.onRequest)}, MyClass ID:{id(sample_01.onMySignal)}")
sample_02.send(f"Signal ID:{id(sample_02.onRequest)}, MyClass ID:{id(sample_02.onMySignal)}")

运行上述代码,输出结果可能如下:

Signal ID:56331376, MyClass ID:15825232
Signal ID:56331392, MyClass ID:15825232

从输出中可以看出,sample_01.onRequest和sample_02.onRequest的内存地址(ID)是不同的,这意味着它们是两个独立的Signal对象。然而,sample_01.onMySignal和sample_02.onMySignal的ID却是相同的,表明它们引用了同一个MyClass对象。这种差异引出了一个核心问题:为什么Signal属性表现出实例唯一性,而普通的MyClass属性则不然?以及如何使MyClass也具有实例唯一性?

立即学习Python免费学习笔记(深入)”;

深入理解Python的类属性与实例属性

要理解上述行为,首先需要明确Python中类属性和实例属性的基本概念:

  • 类属性 (Class Attributes): 定义在类体中,但在任何方法之外的变量。它们属于类本身,由所有实例共享。当一个实例访问一个类属性时,如果该实例没有同名的实例属性,它将访问到类属性。
  • 实例属性 (Instance Attributes): 定义在实例上的变量,通常在类的__init__方法中使用self.attribute = value的形式创建。每个实例都有自己独立的实例属性副本,互不影响。

在我们的示例中,onMySignal = MyClass()被定义为类属性。因此,PSClass的所有实例(sample_01和sample_02)都共享同一个MyClass对象,所以它们的ID是相同的。

描述符协议:Signal实现实例唯一性的机制

Signal之所以能够为每个实例提供唯一的对象,是因为它利用了Python的描述符协议 (Descriptor Protocol)。描述符是实现了特定方法(如__get__, __set__, __delete__)的Python对象。当一个类属性是描述符时,它的访问行为会被这些特殊方法所控制。

PySide2.QtCore.Signal(以及其他一些内置类型,如方法)几乎肯定实现了描述符协议。这意味着当通过实例(例如sample_01.onRequest)访问onRequest时,Signal的__get__方法会被调用。这个__get__方法能够返回一个与当前实例(sample_01)绑定的、独特的Signal对象。这就是为什么即使onRequest被定义为类属性,但每个实例访问它时,都能得到一个独立的、实例绑定的对象。

Python的方法也是描述符的一个典型例子。当你通过实例调用一个方法时(例如sample_01.send()),方法对象会通过描述符协议自动将sample_01绑定为第一个参数self。

海螺音乐
海螺音乐

海螺AI推出的AI音乐生成工具,可以生成个性化的音乐作品。

下载

实现实例唯一性的最佳实践:在__init__中初始化

对于大多数不需要实现复杂行为的普通对象,若要确保每个实例都拥有独立的属性对象,最直接、最Pythonic且最推荐的方法是在类的构造函数__init__中将其定义为实例属性。

通过将onMySignal的初始化从类定义体中移到__init__方法中,我们可以确保每次创建PSClass的新实例时,都会创建一个全新的MyClass对象并绑定到该实例上。

以下是修改后的PSClass定义:

from PySide2.QtCore import QObject, Signal

class MyClass:
    pass

class PSClass(QObject):
    onRequest = Signal(str) # Signal 仍然是类属性,因为它实现了描述符协议

    def __init__(self):
        super().__init__()
        self.onMySignal = MyClass() # 现在 onMySignal 是一个实例属性,每个实例都拥有独立的副本
        self.onRequest.connect(self.printSomething)

    def send(self, message:str):
        self.onRequest.emit(message)

    def printSomething(self, data:str):
        print(data)

sample_01 = PSClass()
sample_02 = PSClass()

sample_01.send(f"Signal ID:{id(sample_01.onRequest)}, MyClass ID:{id(sample_01.onMySignal)}")
sample_02.send(f"Signal ID:{id(sample_02.onRequest)}, MyClass ID:{id(sample_02.onMySignal)}")

现在运行这段代码,输出将变为:

Signal ID:56331376, MyClass ID:15825232
Signal ID:56331392, MyClass ID:15825248 # MyClass ID 现在也不同了

可以看到,onMySignal的ID在sample_01和sample_02之间也变得不同了,这证明每个实例现在都有其独立的MyClass对象。

为何不推荐为普通属性实现描述符协议

虽然理论上可以通过为MyClass实现描述符协议来达到类似Signal的效果,但对于大多数场景而言,这种做法通常不被推荐,原因如下:

  1. 增加不必要的复杂性: 实现描述符协议需要编写额外的特殊方法,这会使代码变得更加复杂和冗长,而对于简单的实例属性需求,这种复杂性是完全没有必要的。
  2. 收益甚微: 如果目标仅仅是让每个实例拥有一个独立的属性对象,那么在__init__方法中进行初始化是最直接、最清晰、最易于维护的方式,实现描述符协议并不能带来额外的实质性好处。
  3. 违背Pythonic原则: 当一个属性被设计为在不同实例之间有所区别时,将其作为类属性定义并依赖描述符协议来“伪装”成实例属性,这通常被认为是反Pythonic的。类属性通常意味着它要么是所有实例共享的,要么是与类本身相关的(即不依赖于实例即可访问,例如PSClass.onMySignal)。如果属性的绑定过程应该为同一实例产生相同的对象(而不是每次访问都重新创建),那么将其在__init__中设置是更符合Python惯例的做法。

总结

理解Python中类属性、实例属性以及描述符协议是编写健壮和高效代码的关键。

  • 类属性默认由所有实例共享,适用于存储常量或所有实例通用的数据。
  • 实例属性通过在__init__方法中初始化来确保每个实例拥有独立的副本,适用于存储实例特有的数据和状态。
  • 描述符协议是Python实现高级属性访问控制的强大机制,例如PySide2.QtCore.Signal和内置方法就是其典型应用。它允许类属性在被实例访问时表现出实例绑定的行为。

对于需要实现实例级唯一性的普通对象,最佳实践始终是在类的__init__方法中进行初始化,以保证代码的简洁性、可读性和Pythonic风格。只有在需要实现复杂且非标准的属性访问逻辑时,才应考虑使用描述符协议。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1502

2023.10.24

class在c语言中的意思
class在c语言中的意思

在C语言中,"class" 是一个关键字,用于定义一个类。想了解更多class的相关内容,可以阅读本专题下面的文章。

469

2024.01.03

python中class的含义
python中class的含义

本专题整合了python中class的相关内容,阅读专题下面的文章了解更多详细内容。

15

2025.12.06

C++ 设计模式与软件架构
C++ 设计模式与软件架构

本专题深入讲解 C++ 中的常见设计模式与架构优化,包括单例模式、工厂模式、观察者模式、策略模式、命令模式等,结合实际案例展示如何在 C++ 项目中应用这些模式提升代码可维护性与扩展性。通过案例分析,帮助开发者掌握 如何运用设计模式构建高质量的软件架构,提升系统的灵活性与可扩展性。

4

2026.01.30

c++ 字符串格式化
c++ 字符串格式化

本专题整合了c++字符串格式化用法、输出技巧、实践等等内容,阅读专题下面的文章了解更多详细内容。

2

2026.01.30

java 字符串格式化
java 字符串格式化

本专题整合了java如何进行字符串格式化相关教程、使用解析、方法详解等等内容。阅读专题下面的文章了解更多详细教程。

1

2026.01.30

python 字符串格式化
python 字符串格式化

本专题整合了python字符串格式化教程、实践、方法、进阶等等相关内容,阅读专题下面的文章了解更多详细操作。

1

2026.01.30

java入门学习合集
java入门学习合集

本专题整合了java入门学习指南、初学者项目实战、入门到精通等等内容,阅读专题下面的文章了解更多详细学习方法。

20

2026.01.29

java配置环境变量教程合集
java配置环境变量教程合集

本专题整合了java配置环境变量设置、步骤、安装jdk、避免冲突等等相关内容,阅读专题下面的文章了解更多详细操作。

16

2026.01.29

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.4万人学习

Django 教程
Django 教程

共28课时 | 3.7万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号