在本节中，我们将学习如何使用 PyQt5 创建一个简单的窗口。这是学习 PyQt5 的第一步。

环境准备

首先，确保你的环境中已经安装了 PyQt5。你可以使用以下命令通过 pip 安装：

1

pip install PyQt5

创建窗口的基本步骤

创建一个基本窗口的步骤主要包括：

1. 导入必要的模块。
2. 创建一个 QApplication 实例。
3. 创建一个窗口类，继承自 QMainWindow 或 QWidget。
4. 显示窗口。
5. 运行应用程序的主循环。

实际代码示例

下面是一个简单的代码示例，展示如何创建第一个 PyQt5 窗口。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

import sys
from PyQt5.QtWidgets import QApplication, QWidget

# 创建窗口类
class MyWindow(QWidget):
    def __init__(self):
        super().__init__()
        self.setWindowTitle('我的第一个窗口')  # 设置窗口标题
        self.setGeometry(100, 100, 400, 300)  # 设置窗口位置与大小 (x, y, width, height)

# 主函数
if __name__ == '__main__':
    app = QApplication(sys.argv)  # 创建QApplication实例
    window = MyWindow()  # 创建窗口实例
    window.show()  # 显示窗口
    sys.exit(app.exec_())  # 进入窗口的主循环

代码详解

1. 导入模块：我们导入了 sys 和 QWidget。sys 是用于系统级操作的模块，而 QWidget 是所有窗口组件的基类。

2. 创建窗口类：MyWindow 类继承自 QWidget。在 __init__ 方法中，我们设置了窗口的标题和大小。

3. 主函数：

   • 创建 QApplication 对象，这是启动 PyQt 应用程序的必要步骤。
   • 实例化我们定义的 MyWindow 类。
   • 调用 show() 方法来显示窗口。
   • 最后，调用 app.exec_() 进入主事件循环，确保程序持续运行。

运行代码

将上述代码保存为一个 .py 文件，例如 first_window.py。然后在终端中运行以下命令：

1

python first_window.py

你应该能看到一个简单的窗口弹出，标题为 “我的第一个窗口”。

总结

在这一小节中，我们学习了如何使用 PyQt5 创建一个简单的窗口。这个窗口虽然功能简单，但它是构建更复杂应用程序的基础。接下来，我们可以进一步探索如何向窗口添加按钮、文本框等组件。

在使用 PyQt5 开发图形用户界面（GUI）时，了解如何运行和调试应用程序是至关重要的。本节将介绍如何启动 PyQt5 应用，以及一些基本的调试技巧。

运行 PyQt5 应用

在编写完你的 PyQt5 代码后，运行应用程序是第一步。通常情况下，一个简单的 PyQt5 应用程序的结构如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("My PyQt5 Application")
        self.setGeometry(100, 100, 800, 600)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec_())

代码解释

• QApplication 是所有 PyQt5 应用程序的核心。它需要传递 sys.argv 作为参数，以便处理命令行参数。
• QMainWindow 是您的主窗口类。您可以在此类中设置窗口的标题、大小等。
• window.show() 方法用于显示窗口。
• app.exec_() 启动应用程序的主事件循环。

运行方式

如果你正在使用命令行，可以通过以下命令运行你的 Python 文件（假设文件名为 my_app.py）：

1

python my_app.py

如果你使用的是集成开发环境（IDE），如 PyCharm 或 VS Code，通常只需点击“运行”按钮或选择相应的菜单选项即可。

调试 PyQt5 应用

调试是确保代码正常工作的关键步骤。以下是一些常用的调试技巧。

使用打印语句

在 PyQt5 中，您可以使用简单的 print() 语句输出调试信息。这里是一个例子：

1
2
3
4
5
6
7
8
9
10
11
12
13
14

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("My PyQt5 Application")
        self.setGeometry(100, 100, 800, 600)

        # 打印调试信息
        print("MainWindow initialized")

        self.button = QPushButton("Click Me", self)
        self.button.clicked.connect(self.on_button_click)

    def on_button_click(self):
        print("Button clicked!")

这样，当您点击按钮时，会在控制台输出“Button clicked!”的信息，以帮助您跟踪程序的执行状态。

使用调试器

许多 IDE 提供内置调试器，允许您设置断点并逐步执行代码。例如，在 PyCharm 中，您可以：

1. 将光标放在行号旁边，点击设置断点。
2. 选择“调试”选项来运行程序。
3. 使用调试工具窗口逐步执行。查看变量的值和应用的状态。

捕获异常

在 PyQt5 应用中，您可以通过 try-except 块捕获潜在的异常，以避免程序崩溃。例如：

1
2
3
4
5
6

try:
    # 可能会引发异常的代码
    self.button = QPushButton("Click Me", self)
    self.button.clicked.connect(self.on_button_click)
except Exception as e:
    print(f"An error occurred: {e}")

总结

掌握运行和调试技巧，是成功使用 PyQt5 开发应用的基础。通过适当的运行方式、加入调试信息并使用断点，您可以有效地定位和解决问题。继续练习，您会越来越熟练！

在本小节中，我们将学习如何使用 PyQt5 创建和操作一个基本的窗口。PyQt5 是一个非常流行的 Python GUI 库，可以帮助我们快速创建图形用户界面。

环境准备

首先，确保你的系统中已经安装了 PyQt5。可以使用以下命令进行安装：

1

pip install PyQt5

创建基础窗口

下面是创建一个简单窗口的步骤：

1. 引入必要的模块

首先，我们需要导入 PyQt5 中的基本模块：

1
2

import sys
from PyQt5.QtWidgets import QApplication, QWidget

2. 创建应用程序

每个 PyQt5 应用程序都需要一个 QApplication 对象。这是应用程序的主控件。

3. 创建窗口

接下来，我们创建一个 QWidget 实例来作为窗口，并设置窗口的基本属性，例如标题和尺寸。

4. 显示窗口

最后，我们调用 show() 方法来展示窗口。

完整示例代码

以下是创建一个基本窗口的完整代码示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

import sys
from PyQt5.QtWidgets import QApplication, QWidget

def main():
    # 创建应用程序对象
    app = QApplication(sys.argv)
    
    # 创建窗口对象
    window = QWidget()
    window.setWindowTitle('我的第一个窗口')
    window.setGeometry(100, 100, 600, 400)  # 窗口位置 (x, y) 和尺寸 (宽, 高)
    
    # 显示窗口
    window.show()
    
    # 运行应用程序的主循环
    sys.exit(app.exec_())

if __name__ == '__main__':
    main()

窗口的基本操作

窗口属性

我们可以使用多个方法来设置窗口的属性：

• setWindowTitle(title)：设置窗口标题。
• setGeometry(x, y, width, height)：设置窗口的位置和尺寸。
• resize(width, height)：改变窗口的尺寸。

理解坐标系

在 PyQt5 中，窗口的坐标系以屏幕的左上角为原点 (0, 0)，x 轴向右延伸，y 轴向下延伸。

示例：调整窗口位置和大小

我们可以通过添加一些代码来调整窗口的初始位置和大小：

1

window.setGeometry(200, 200, 800, 600)  # 修改窗口位置和尺寸

运行程序后效果

当我们运行程序后，会看到一个标题为“我的第一个窗口”的窗口，位置在屏幕的 (200, 200)，大小为 800x600 像素。

小结

在本小节中，我们了解了如何使用 PyQt5 创建一个基本的窗口应用，包括设置标题、位置和尺寸等基本操作。通过学习这些基本操作，你可以进一步探索更多的 PyQt5 特性和控件，来丰富你的图形界面应用。