【学习记录】快速上手 PyQt6：设置 Qt Designer、PyUIC 和 PyRCC 在 PyCharm中的应用

📌 前言

在使用 PyQt6 进行图形界面开发时，Qt Designer 是一个非常强大的可视化 UI 设计工具。通过它，你可以拖拽控件快速设计界面，并生成 .ui 文件。为了将 .ui 文件转换为 Python 可用的代码，我们还需要使用 pyuic6 工具；而资源文件（如图标、图片）则需要使用 pyrcc6 编译为 .py 文件。

本文将详细介绍：

• 如何安装 Qt Designer；
• 如何在常用 IDE 中添加 QtDesigner、PyUIC 和 PyRCC 作为外部工具；
• 如何使用这些工具完成从设计到代码生成的全过程。

✅ 第一步：安装 PyQt6 及其工具包

确保你已经安装了 PyQt6 和相关工具：

pip install pyqt6 pyqt6-tools

✅ 安装完成后：

• designer.exe 就是 Qt Designer；
• pyuic6 用于将 .ui 文件转为 .py；
• pyrcc6 用于将 .qrc 资源文件编译为 .py。

🔧 第二步：找到相关工具路径

安装完成后，在你的 Python 环境目录下查找以下三个关键程序：

默认路径如下（根据你的 Python 版本和安装位置可能不同）：

📌 提示：你也可以在命令行输入以下命令来查看具体路径：

where designer
where pyuic6
where pyrcc6

🧰 第三步：在 PyCharm 中配置外部工具

打开设置

打开 PyCharm → File → Settings (Ctrl + Alt + S) → Tools → External Tools

点击 + 添加新工具。

🛠️ 配置 Qt Designer

• Name: Qt Designer
• Description: 启动 Qt 可视化界面设计器
• Program: 浏览选择 designer.exe
• Arguments: $FileName$
• Working directory: $FileDir$

🛠️ 配置 PyUIC6（UI转Python）

• Name: PyUIC6
• Description: 将 .ui 文件转换为 Python 代码
• Program: 浏览选择 pyuic6.exe
• Arguments: -x "$FileName$" -o "$FileNameWithoutExtension$.py"
• Working directory: $FileDir$

📌 使用方式：右键 .ui 文件 → External Tools → Run PyUIC6，即可生成对应的 .py 文件。

🛠️ 配置 PyRCC6（资源文件编译）

• Name: PyRCC6
• Description: 将 .qrc 资源文件编译为 Python 代码
• Program: 浏览选择 pyrcc6.exe
• Arguments: "$FileName$" -o "$FileNameWithoutExtension$_rc.py"
• Working directory: $FileDir$

📌 使用方式：右键 .qrc 文件 → External Tools → Run PyRCC6，生成 _rc.py 文件供主程序引用。

💡 第四步：实际使用流程示例

1. 使用 Qt Designer 创建 UI 文件

• 打开 Qt Designer（可通过 PyCharm 外部工具启动）
• 新建一个 Main Window 或 Widget
• 拖入按钮、标签等控件并布局
• 保存为 main_window.ui

2. 使用 PyUIC6 转换 UI 文件

• 在 PyCharm 中右键 main_window.ui
• 选择 External Tools → PyUIC6
• 自动生成 main_window.py 文件

3. 编写主程序调用 UI

import sys
from PyQt6.QtWidgets import QApplication, QMainWindow
from main_window import Ui_MainWindow

class MyMainWindow(QMainWindow, Ui_MainWindow):
    def __init__(self):
        super().__init__()
        self.setupUi(self)

        # 绑定按钮事件
        self.pushButton.clicked.connect(self.on_click)

    def on_click(self):
        print("按钮被点击")

if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = MyMainWindow()
    window.show()
    sys.exit(app.exec())

4. 使用 PyRCC6 编译资源文件（可选）

如果你在 .ui 中使用了图标或其他资源，需创建 .qrc 文件并编译：

<RCC>
    <qresource prefix="/">
        <file>icon.png</file>
    </qresource>
</RCC>

右键 .qrc 文件 → Run PyRCC6 → 生成 _rc.py 文件后，在代码中引用即可：

self.pushButton.setIcon(QIcon(':/icon.png'))

🧩 其他 IDE 配置方法（简要说明）

Visual Studio Code

• 使用 Tasks 或扩展（如 “Python Qt Tools”）
• 自定义 tasks.json 文件配置命令行执行 pyuic6 / pyrcc6

Microsoft Visual Studio 2022

• 使用“外部工具”菜单（Tools → External Tools…）
• 添加 Qt Designer、PyUIC6、PyRCC6 的快捷方式

✅ 总结

通过本文的指导，你可以在常用的开发环境中轻松集成 Qt Designer、PyUIC 和 PyRCC 工具，实现从界面设计到代码生成的一站式开发流程。这不仅提升了开发效率，也让界面设计更加直观、专业。

📌 如果你觉得这篇文章对你有帮助，请点赞 + 收藏 + 分享，让更多人了解如何解决 Element UI 引入时的样式报错问题！

💬 欢迎留言讨论你在使用 Element UI 或其他 UI 框架时遇到的类似问题。