在 PySide6有一些常用的装饰器和工具，用于增强代码的功能和可读性。以下是一些常见的装饰器及其用法：
1. @staticmethod
@staticmethod 是 Python 内置的装饰器，用于声明静态方法。静态方法不需要访问类实例或类本身，可以直接通过类名调用。
示例：
class MyClass:@staticmethoddef my_static_method():print("This is a static method")# 调用静态方法
MyClass.my_static_method()
2. @classmethod
@classmethod 是 Python 内置的装饰器，用于声明类方法。类方法的第一个参数是类本身（通常命名为 cls），而不是实例。
示例：
class MyClass:@classmethoddef my_class_method(cls):print(f"This is a class method of {cls.__name__}")# 调用类方法
MyClass.my_class_method()
3. @property
@property 是 Python 内置的装饰器，用于将方法转换为属性。通过 @property，你可以像访问属性一样访问方法，而不需要显式调用方法。
示例：
class MyClass:def __init__(self):self._value = 10@propertydef value(self):return self._value@value.setterdef value(self, new_value):self._value = new_value# 使用属性
obj = MyClass()
print(obj.value) # 访问属性
obj.value = 20 # 设置属性
4. @functools.lru_cache
@functools.lru_cache 是 Python 标准库 functools 中的装饰器，用于缓存函数的返回值，避免重复计算。
示例：
import functools@functools.lru_cache(maxsize=128)
def fibonacci(n):if n < 2:return nreturn fibonacci(n - 1) + fibonacci(n - 2)# 调用函数
print(fibonacci(10)) # 结果会被缓存
5. Signal
在 PySide6 中，PySide6.QtCore.Signal 用于声明自定义信号。信号是 Qt 框架中用于对象间通信的机制。
示例：
from PySide6.QtCore import QObject, Signalclass MyObject(QObject):my_signal = Signal(int) # 声明一个带 int 参数的信号def trigger_signal(self):self.my_signal.emit(42) # 发射信号# 使用信号
obj = MyObject()
obj.my_signal.connect(lambda value: print(f"Signal received: {value}"))
obj.trigger_signal()
6. @PySide6.QtCore.Property
@PySide6.QtCore.Property 是 PySide6 中的装饰器，用于声明 Qt 属性。Qt 属性可以在 QML 或 Qt Designer 中使用。
示例：
from PySide6.QtCore import QObject, Propertyclass MyObject(QObject):def __init__(self):super().__init__()self._value = 10@Property(int) # 声明一个 int 类型的 Qt 属性def value(self):return self._value@value.setterdef value(self, new_value):self._value = new_value# 使用 Qt 属性
obj = MyObject()
print(obj.value) # 访问属性
obj.value = 20 # 设置属性
7. @contextlib.contextmanager
@contextlib.contextmanager 是 Python 标准库 contextlib 中的装饰器，用于创建上下文管理器。上下文管理器通常用于资源管理（如文件操作、数据库连接等）。
示例：
from contextlib import contextmanager@contextmanager
def open_file(file_name, mode):file = open(file_name, mode)try:yield filefinally:file.close()# 使用上下文管理器
with open_file("test.txt", "w") as f:f.write("Hello, World!")
8. @dataclasses.dataclass
@dataclasses.dataclass 是 Python 标准库 dataclasses 中的装饰器，用于自动生成类的 __init__、__repr__ 等方法，简化类的定义。
示例：
from dataclasses import dataclass@dataclass
class Point:x: inty: int# 使用数据类
p = Point(10, 20)
print(p) # 输出: Point(x=10, y=20)
9. @typing.overload
@typing.overload 是 Python 标准库 typing 中的装饰器，用于声明函数的重载。它可以帮助静态类型检查工具（如 mypy）理解函数的不同调用方式。
示例：
from typing import overload@overload
def process(value: int) -> int: ...
@overload
def process(value: str) -> str: ...def process(value):if isinstance(value, int):return value * 2elif isinstance(value, str):return value.upper()# 调用函数
print(process(10)) # 输出: 20
print(process("hello")) # 输出: HELLO
10. @unittest.mock.patch
@unittest.mock.patch 是 Python 标准库 unittest.mock 中的装饰器，用于在单元测试中模拟对象或函数的行为。
示例：
from unittest.mock import patchdef my_function():return 42@patch("__main__.my_function", return_value=100)
def test_my_function(mock_function):assert my_function() == 100# 运行测试
test_my_function()
11. @flag
@flag用于定义一个标志类型。标志类型可以用于表示多个选项的组合。
示例：
from PySide6.QtCore import Flag@Flag
class MyFlags:Flag1 = 0x1Flag2 = 0x2Flag3 = 0x4 12. @Enum
@Enum用于定义一个枚举类型。枚举类型在处理有限的选择集合时非常有用。
示例：
from PySide6.QtCore import Enum@Enum
class MyEnum:Option1 = 0Option2 = 1Option3 = 2 13. QMetaObject.connectSlotsByName()
QMetaObject.connectSlotsByName() 是 Qt 框架中的一个函数，用于自动将某个对象的信号和槽通过名称匹配的方式连接起来。这个函数通常在自定义的 QObject 子类中使用，特别是在实现自定义的 UI 控件或组件时，可以简化信号和槽的连接过程。
示例：
class MyWidget(QWidget):def __init__(self):super().__init__()# 设置UIself.setupUi()# 自动连接信号和槽QMetaObject.connectSlotsByName(self)def setupUi(self):# 创建一个按钮，并设置对象名self.button = QPushButton("Click me", self)self.button.setObjectName("button")@pyqtSlot()def on_button_clicked(self):print("Button clicked!")命名规则：
connectSlotsByName() 会根据槽函数的命名规则来匹配信号和槽。槽函数的命名规则如下：
槽函数名称: on_<objectName>_<signalName>
objectName: 对象的名称，通常通过 setObjectName() 设置。
signalName: 信号的名称，通常是信号的函数名去掉参数部分。
例如，如果有一个名为 button 的按钮对象，并且希望在按钮被点击时触发某个操作，可以定义一个槽函数名为 on_button_clicked。这样，connectSlotsByName() 会自动将 button 的 clicked 信号连接到这个槽函数。
需要知道的是：使用pyuic转换而来的.py文件代码中，QMetaObject.connectSlotsByName()命令已经被自动添加了，所以只需要根据槽函数的命名规则进行命名使用即可。
总结
| 装饰器 | 用途 |
|---|---|
@staticmethod | 声明静态方法，无需访问实例或类。 |
@classmethod | 声明类方法，第一个参数是类本身。 |
@property | 将方法转换为属性，支持 getter 和 setter。 |
@functools.lru_cache | 缓存函数返回值，避免重复计算。 |
@PySide6.QtCore.Signal | 声明自定义信号，用于对象间通信。 |
@PySide6.QtCore.Property | 声明 Qt 属性，支持在 QML 或 Qt Designer 中使用。 |
@contextlib.contextmanager | 创建上下文管理器，用于资源管理。 |
@dataclasses.dataclass | 自动生成类的 __init__、__repr__ 等方法，简化类定义。 |
@typing.overload | 声明函数重载，帮助静态类型检查工具理解函数的不同调用方式。 |
@unittest.mock.patch | 在单元测试中模拟对象或函数的行为。 |
@flag | 定义一个标志类型。 |
@Enum | 定义一个枚举类型。 |
connectSlotsByName() | 将对象的信号和槽通过名称匹配的方式连接起来 |
这些装饰器在 Python 和 PySide6 开发中非常有用，可以帮助你编写更简洁、高效和可维护的代码。根据具体需求选择合适的装饰器，可以显著提升开发效率。
