### ### PyQt5.QtWidgets模块的功能与用途 PyQt5.QtWidgets 是 PyQt5 库中的一个模块，它提供了丰富的图形用户界面（GUI）组件，用于构建窗口、对话框、按钮、文本框、列表框、菜单等界面元素。该模块基于 Qt 框架，支持跨平台开发，适用于 Windows、Linux、macOS 等操作系统，能够帮助开发者快速构建现代化、美观的桌面应用程序[^3]。 PyQt5.QtWidgets 模块包含了一系列 UI 控件，适用于创建符合系统风格的经典界面。通过该模块可以实现窗口布局、事件响应、界面交互等功能，是开发 PyQt5 图形界面应用的核心模块之一[^1]。 ### ### 常用类及其功能 以下是一些 PyQt5.QtWidgets 模块中常用的类及其基本用途： - **QWidget**：基础控件类，所有用户界面元素都继承自该类。用于创建窗口、对话框等基础界面组件。 - **QLabel**：用于显示文本或图像，不支持交互操作。 - **QPushButton**：标准按钮控件，点击时可以触发事件。 - **QLineEdit**：单行文本输入框，用于接收用户输入的文本。 - **QTextEdit**：多行文本编辑控件，支持格式化文本。 - **QComboBox**：下拉选择框，允许用户从预定义的选项中选择。 - **QCheckBox**：复选框控件，用于表示可选中的状态。 - **QRadioButton**：单选按钮，用于在多个选项中选择一个。 - **QListWidget**：列表控件，显示多个条目供用户选择。 - **QTableWidget**：表格控件，支持多行多列的数据展示和编辑。 - **QTabWidget**：选项卡控件，用于组织多个页面。 - **QMenuBar、QToolBar、QStatusBar**：分别用于创建菜单栏、工具栏和状态栏，构建完整的应用程序界面结构。 ### ### 示例代码 以下是一个使用 PyQt5.QtWidgets 模块创建简单窗口的示例： ```python from PyQt5.QtWidgets import QApplication, QWidget, QLabel, QPushButton, QVBoxLayout app = QApplication([]) # 创建主窗口 window = QWidget() window.setWindowTitle("PyQt5 示例") # 创建控件 label = QLabel("这是一个标签") button = QPushButton("点击我") # 定义按钮点击事件 def on_click(): label.setText("按钮被点击了！") button.clicked.connect(on_click) # 设置布局 layout = QVBoxLayout() layout.addWidget(label) layout.addWidget(button) window.setLayout(layout) # 显示窗口 window.show() # 运行应用 app.exec_() ``` 上述代码创建了一个包含标签和按钮的窗口，并通过信号与槽机制实现按钮点击后的文本更新功能。这体现了 PyQt5.QtWidgets 在界面构建与事件响应方面的强大能力。 ### ### 注意事项 在使用 PyQt5.QtWidgets 模块时，需要注意避免将项目文件命名为 `PyQt5.py`，否则会导致模块导入失败并提示 `ModuleNotFoundError: No module named 'PyQt5.QtWidgets'` 错误。此问题通常是因为 Python 优先加载了本地同名文件而非实际的 PyQt5 包[^4]。 ---