1. 目标

在本指南中，我们将一起创建一个简单的PyQt应用程序。这个程序将包含一个窗口，窗口内有一个按钮。当用户点击按钮时，会在控制台输出一条消息。

2. 准备工作

确保你已经安装了PyQt5或PyQt6。如果没有安装，可以使用以下命令进行安装：

pip install PyQt5
# 或者
pip install PyQt6

3. 创建应用程序

以下是创建第一个PyQt应用程序的完整代码：

import sys
from PyQt5.QtWidgets import QApplication, QWidget, QPushButton

# 定义一个槽函数，当按钮被点击时会调用这个函数
def on_button_click():
    print("按钮被点击了！")

# 创建应用程序对象
app = QApplication(sys.argv)

# 创建窗口对象
window = QWidget()
window.setWindowTitle("我的第一个PyQt应用程序")
window.setGeometry(100, 100, 300, 200)  # 设置窗口的位置和大小

# 创建按钮对象
button = QPushButton("点击我", window)
button.setGeometry(100, 80, 100, 30)  # 设置按钮的位置和大小
button.clicked.connect(on_button_click)  # 将按钮的点击信号连接到槽函数

# 显示窗口
window.show()

# 进入主循环，等待事件发生
sys.exit(app.exec_())

4. 代码解析

• 导入模块：首先导入了必要的PyQt5模块。
• 定义槽函数：on_button_click 函数将在按钮被点击时执行。
• 创建应用程序对象：QApplication 对象是整个应用程序的核心。
• 创建窗口对象：QWidget 是所有用户界面对象的基类，这里用作主窗口。
• 设置窗口属性：设置了窗口的标题和大小。
• 创建按钮对象：QPushButton 是一个按钮组件。
• 设置按钮属性：设置了按钮的文本和位置大小。
• 连接信号和槽：使用 clicked.connect() 方法将按钮的点击信号连接到槽函数。
• 显示窗口：调用 show() 方法使窗口可见。
• 进入主循环：app.exec_() 使程序进入事件循环，等待用户操作。

5. 运行程序

将上述代码保存为一个 .py 文件，例如 first_pyqt_app.py，然后在命令行中运行：

python first_pyqt_app.py

你应该会看到一个包含“点击我”按钮的窗口。点击按钮后，控制台会输出“按钮被点击了！”的消息。

6. 下一步

现在你已经成功创建了第一个PyQt应用程序，接下来可以尝试添加更多的组件和功能，比如文本框、标签、菜单等，逐步构建更复杂的应用程序。