第3章 搭建PyQt5開發環境

俗話說“工欲善其事，必先利其器”，要使用Python+PyQt5進行GUI圖形用戶界面程序的開發，首先需要搭建好開發環境，開發PyQt5程序，主要需要Python解釋器、PyCharm開發工具（也可以是其他工具）、PyQt5相關的模塊，本章將對如何搭建PyQt5開發環境進行詳細講解。

3.1　PyCharm開發工具的下載與安裝

PyCharm是由JetBrains公司開發的一款Python開發工具，在Windows、Mac OS和Linux操作系統中都可以使用，它具有語法高亮顯示、Project（項目）管理代碼跳轉、智能提示、自動完成、調試、單元測試和版本控制等功能。使用PyCharm可以大大提高Python項目的開發效率，本節將對PyCharm開發工具的下載與安裝進行詳細講解。

3.1.1　下載PyCharm

PyCharm的下載非常簡單，可以直接訪問Jetbrains公司官網下載地址：https://www.jetbrains.com/pycharm/download/，打開PyCharm開發工具的官方下載頁面，單擊頁面右側“Community”下的Download按鈕，下載PyCharm開發工具的免費社區版，如圖3.1所示。

下載完成后的PyCharm安裝文件如圖3.2所示。

3.1.2　安裝PyCharm

安裝PyCharm的步驟如下。

（1）雙擊PyCharm安裝包進行安裝，在歡迎界面單擊“Next”按鈕進入軟件安裝路徑設置界面。

（2）在軟件安裝路徑設置界面，設置合理的安裝路徑。PyCharm默認的安裝路徑為操作系統所在的路徑，建議更改，因為如果把軟件安裝到操作系統所在的路徑，當出現操作系統崩潰等特殊情況而必須重做系統時，PyCharm程序路徑下的程序將被破壞。另外在安裝路徑中建議不要有中文和空格。如圖3.3所示。單擊“Next”按鈕，進入創建快捷方式界面。

（3）在創建桌面快捷方式界面（Create Desktop Shortcut）中設置PyCharm程序的快捷方式。如果計算機操作系統是32位，選擇“32-bit launcher”，否則選擇“64-bit launcher”。筆者的計算機操作系統是64位系統，所以選擇“64-bit launcher”；接下來設置關聯文件（Create Associations），選中.py左側的復選框，這樣以后再打開.py文件（Python腳本文件）時，會默認使用PyCharm打開；選中“Add launchers dir to the PATH”復選框，如圖3.4所示。

（4）單擊“Next”按鈕，進入選擇開始菜單文件夾界面，采用默認設置即可，單擊“Install”按鈕（安裝大概需要10分鐘），如圖3.5所示。

（5）安裝完成后，單擊“Finish”按鈕，完成PyCharm開發工具的安裝，如圖3.6所示。

3.1.3　啟動并配置PyCharm

啟動并配置PyCharm開發工具的步驟如下。

（1）PyCharm安裝完成后，會在開始菜單中建立一個快捷菜單，如圖3.7所示，單擊“PyCharm Community Edition 2019.3.3”，即可啟動PyCharm程序。

另外，還會在桌面創建一個“PyCharm Community Edition 2019.3.3”快捷方式，如圖3.8所示，通過雙擊該圖標，同樣可以啟動PyCharm。

（2）啟動PyCharm程序后，進入閱讀協議頁，選中“I confirm that I have read and accept the terms of this User Agreement”復選框，單擊Continue按鈕，如圖3.9所示。

（3）進入PyCharm歡迎頁，單擊“Create New Project”按鈕，創建一個Python項目，如圖3.10所示。

（4）在第一次創建Python項目時，需要設置項目的存放位置以及虛擬環境路徑，這里需要注意的是，設置的虛擬環境的“Base interpreter”解釋器應該是python.exe文件的地址，設置過程如圖3.11所示。

（5）設置完成后，單擊圖3.11所示的“Create”按鈕，即可進入PyCharm開發工具的主窗口，效果如圖3.12所示。

3.2　在PyCharm中配置PyQt5環境

安裝完Python解釋器和PyCharm開發工具之后，在PyCharm中安裝并配置好PyQt5，就可以使用PyQt5進行GUI圖形用戶界面程序的開發了，本節將對如何在PyCharm中安裝、配置PyQt5環境進行詳細講解。

3.2.1　安裝PyQt5及設計器

在PyCharm中安裝PyQt5及設計器的具體步驟如下。

（1）在PyCharm開發工具的主窗口中依次選擇“File”→“Settings”菜單，如圖3.13所示。

（2）打開PyCharm的設置窗口，展開Project節點，單擊“Project Interpreter”選項，單擊窗口最右側的“+”按鈕，如圖3.14所示。

（3）彈出“Available Packages”窗口，如圖3.15所示，該窗口主要列出所有可用的Python模塊，但我們發現，圖3.15所示并沒有可用Python模塊，這是為什么呢？這主要是由于默認的可用Python模塊都是從Python的官網加載的，而Python官網由于是一個國外的網站，訪問速度特別慢，所以這里就會加載得很慢，因此建議增加國內提供的可用鏡像站點，單擊“Manage Repositories”按鈕。

（4）彈出“Manage Repositories”窗口，單擊右側“+”按鈕，如圖3.16所示，彈出“Repositories URL”窗口，在該窗口的文本框中輸入一個國內的Python模塊鏡像地址，例如，在這里輸入清華大學提供的鏡像地址：https://pypi.tuna.tsinghua.edu.cn/simple，如圖3.17所示，依次單擊OK按鈕，返回“Available Packages”窗口。

（5）這時在“Available Packages”窗口中就可以很快地顯示所有可用的Python模塊，在上方的文本框中輸入pyqt5，按Enter鍵，即可篩選出所有與pyqt5相關的模塊，分別選中pyqt5、pyqt5-tools、pyqt5designer，并單擊“Install Package”進行安裝，如圖3.18所示。

（6）安裝完以上3個模塊后，關閉“Available Packages”窗口，在“Project Interpreter”窗口中即可看到安裝的PyQt5相關模塊及依賴包，如圖3.19所示。

安裝完PyQt5后，其相關的文件都存放在當前虛擬環境的“Lib\site-packages”文件夾下，如圖3.20所示。

3.2.2　配置PyQt5設計器及轉換工具

由于使用PyQt5創建GUI圖形用戶界面程序時，會生成擴展名為.ui的文件，該文件需要轉換為.py文件后才可以被Python識別，所以需要對PyQt5與PyCharm開發工具進行配置。

接下來配置PyQt5的設計器，及將.ui文件（使用PyQt5設計器設計的文件）轉換為.py文件（Python腳本文件）的工具，具體步驟如下。

（1）在PyCharm開發工具的設置窗中依次選擇“Tools”→“External Tools”選項，然后在右側單擊“+”按鈕，彈出“Create Tool”窗口。在該窗口中，首先在“Name”文本框中填寫工具名稱為Qt Designer，然后單擊“Program”后面的文件夾圖標，選擇安裝pyqt5designer模塊時自動安裝的designer.exe文件，該文件位于當前虛擬環境的“Lib\site-packages\QtDesigner\”文件夾中，最后在“Working directory”文本框中輸入$ProjectFileDir$，表示項目文件目錄，單擊OK按鈕，如圖3.22所示。

（2）按照上面的步驟配置將.ui文件轉換為.py文件的轉換工具，在“Name”文本框中輸入工具名稱為PyUIC，然后單擊“Program”后面的文件夾圖標，選擇虛擬環境目錄下的pyuic5.exe文件，該文件位于當前虛擬環境的“Scripts”文件夾中，接下來在“Arguments”文本框中輸入將.ui文件轉換為.py文件的命令：-o $FileNameWithoutExtension$.py $FileName$；最后在“Working directory”文本框中輸入$ProjectFileDir$，它表示UI文件所在的路徑，單擊OK按鈕，如圖3.23所示。

完成以上配置后，在PyCharm開發工具的菜單中展開“Tools”→“External Tools”菜單，即可看到配置的Qt Designer和PyUIC工具，如圖3.24所示，這兩個菜單的使用方法如下。

　選擇“Qt Designer”菜單，可以打開QT設計器。

　選擇一個.ui文件，單擊“PyUIC”菜單，即可將選中的.ui文件轉換為.py代碼文件。

3.3　小結

本章主要對PyCharm開發工具的下載與安裝，以及如何在PyCharm開發工具中配置PyQt5環境進行了詳細講解。本章所講解的知識是進行PyQt5程序開發的基礎，讀者在學習時，一定要熟練掌握。