[Python 練習筆記] PySide6 做一個簡單的GUI Application #0：簡介與設定

目錄：

***1. 前言

• 1.1 系列其他筆記連結
• 1.2 參考資料、網站***

***2. 環境及設定

• 2.1 從下載安裝 Python 開始
• 2.2 安裝 PySide6、Pillow (Python Imaging Library (Fork))
• 2.3 簡單快速驗證一下是否安裝成功***

1. 前言：

跟著網路上好多的 Python 入門教學來自學，在精通了 print(“hello world”) 後，我發現它們都只能在黑盒子或是 Notebook 裡打招呼。

我想要它們像我桌面上其他應用程式一樣有個視窗，然後點個按鈕就蹦出一張圖或是一行 hello world 之類的。也就是說，我想用 Python 寫一個圖形使用者介面（Graphical User Interface，GUI）。

於網路搜尋一番後，找到了 Python 圖形介面開發的幾種方案。我選了其中的 PySide，因此就有了這幾篇筆記。

筆記主要紀錄我在寫程式中的心路歷程、遇到的問題及其解決方法。總體風格會有點像半教學文的概念。內容則如標題「做一個簡單的 GUI Application」所述，筆記將會以實作一個簡單的應用程式為主幹，講解途中如何用到 PySide6 來實現程式功能。

也因是非常簡單的小小程式，所涉略 PySide 功能不多，若想瞭解一些深入概念或功能，可以根據自身需求來谷歌或參考官方文檔等。

我是初學 + 自學，許多東西瞭解不深，皆先求程式會動就行，其中不免會出現少許紕漏。若有讀者發現，請務必指出錯誤，也希望各位能不吝賜教，指點迷津一下。在此先感謝大大們了 <( )> 。

另外2.2處開始才會提到 PySide6。如果完全不知道 PySide6 是什麼，可以先滑下去看，或是閱讀下面1.2處我參考的幾個教學網站或資料。

1.1. 系列其他筆記連結

以下為此系列所有筆記，共九篇。每篇筆記都會介紹不同的主題，以此一步一步完成我自己那簡單的 GUI 應用程式。

***- 筆記 #0：簡介與設定 — 介紹筆記主要紀錄內容以及環境設定。

• 筆記 #1：規格與準備 — 定義應用程式的規格並準備開始實作。
• 筆記 #2：顯示UI — 使用 Python 顯示應用程序界面。
• 筆記 #3：常用 widget 介紹 — 介紹我的應用程式用到的部件。
• 筆記 #4：佈局（Layout） — 學習如何使用佈局管理部件的排列。
• 筆記 #5：載入、顯示、儲存圖片 — 實作載入、顯示和儲存圖片的功能。
• 筆記 #6：自定義部件 — 介紹如何自定義部件。
• 筆記 #7：滑鼠事件 — 介紹滑鼠事件以實現部件與用戶的滑鼠互動。
• 筆記 #8：裁剪圖片* — 介紹如何選取範圍來實現圖片裁剪的功能。

1.2 參考資料、網站

以下都是我在初學使用 PySide6 時，於網路上所搜尋到的參考和教學資料。這些網站內容都很詳細且優秀，可佐以本筆記來一同閱讀，如此來提高你的學習效率和相關知識深度。

• ***Tutorials — Qt for Python | Qt for Python***

- 【PyQt5】Day 1 — 安裝 PyQt，建立自己的第一支 PyQt5 程式 | Howard Weng

- PySide #1: Python GUI開發，簡介 & 環境安裝 | DekBan

- Python Qt 简介 | 白月黑羽

- Learn Python GUI Development for Desktop — PySide6 and Qt Tutorial | freeCodeCamp.org

當然還有其他的參考，這裡我只列出一些，在網路搜尋後還有許多優秀資料及教學。若有空，我更推薦你自己慢慢瀏覽過在搜尋結果裡的那些網站，挑選出適合自己步調的教學。

咦？你說上面教學文章講的怎麼是PyQt5、PySide2？跟 PySide6 沒有差嗎？

當然是有差，但這裡引用 Python Qt 简介中的講解：

「兩個庫的使用 對程序員來說，差別很小：它們的調用接口幾乎一模一樣。如果你的程序是 PyQt5 開發的，通常只要略作修改，比如把導入的名字從 PyQt5 換成 PySide2 就行了。反之亦然。」

如果真的對兩者差別有興趣，可以直接 Google，網友們都有整理出不少的說明與解釋。

還有雖然上面說大部分情況下將 import PyQt5改成 import PySide6 就行，但 Debug 時請務必將差異考慮進去，一些 class 或 module 在兩個庫中可能不相同。

另外在此，我要特別感謝網路上各位大大的分享與心得、以及網路本身。儘管素未謀面且相隔千里，我仍能透過網路便捷的獲取知識和幫助。真的特別感謝。(´,,•ω•,,)♡

2. 環境及設定：

開始前先記錄我所使用的各軟體版本，方便日後檢查錯誤。

作業系統：Windows 10，64 位元作業系統 Python 版本：3.11.0 PySide6 版本：6.2.4 Pillow 版本：9.1.0

2.1 從下載安裝 Python 開始

這裡就看這一篇來安裝： [Python 練習筆記] 安裝Python。

OK就可以到 2.2 囉。

雖說是從安裝 python 開始，但這系列筆記是假設個人已經有一些簡單基礎的 python 語法知識。

大概要多少？ 就基礎的那些：

瞭解變數、資料類型、條件判斷、迴圈等概念及用法，也就是知道該怎麼使用列表（List）、if else、for 等等。以及瞭解函數和類（Class）：知道如何定義和使用函數，以及如何創建 class 和使用 class 中的方法。

2.2 安裝 PySide6、Pillow (Python Imaging Library (Fork))

- 怎麼裝？

點擊「開始」按鈕（Windows 圖示），在開始選單的搜尋框輸入 “cmd” 。 之後點擊「命令提示字元」，輸入：

pip install PySide6

pip install Pillow

喔天阿，你已經直接輸入然後安裝了嗎？如果是，那下次裝任何東西之前請先查詢一下：我安裝的是什麼、裝了可以做什麼。維護資訊安全你我有責。

- PySied6 是什麼？

***PySide6 能讓你能透過 Python 語言，使用 Qt 的功能來建立應用程式。簡單來說，PySide6 可以讓我們用 Python 寫 GUI 程式。***

” PySide6 is the official Python module from the Qt for Python project, which provides access to the complete Qt 6.0+ framework.” (PySide6 · PyPI)

什...什麼？

「 PySide6 是 Qt for Python 項目的官方 Python 模組，它提供對完整 Qt 6.0+ 框架的訪問。」

那 Qt 呢？

Qt 是一個跨平台的 C++ 應用程式開發框架，廣泛用於開發 GUI 程式。它包含了一系列用於建立圖形使用者介面、網路通訊、多媒體處理等功能的程式庫。

綜上所述，我簡單總結一下：PySide6 能讓你能透過 Python 語言，使用 Qt 的功能並建立應用程式。

我這樣敘述可能還是會讓你看不明白。總而言之：PySide6 可以讓我們用 Python 寫 GUI 程式。

- Pillow 是什麼？

***PIL(Pillow) 是 Python 中一個流行的圖像處理庫。它提供了許多功能，使開發者可以輕鬆地讀取、編輯和保存各種圖像格式的圖片。***

PySide6 我懂，為什麼裝 Pillow？因為我想做一個跟圖片處理有關的小小GUI 應用。

2.3 簡單快速驗證一下是否安裝成功

開啟你的 Python，輸入下面 Code，簡單快速驗證一下是否安裝成功：

import PySide6.QtCore

# Prints PySide6 version
print(PySide6.__version__)

# Prints the Qt version used to compile PySide6
print(PySide6.QtCore.__version__)

想看視窗出現？新建一個 python 檔案，叫 「hello_world.py」 。然後貼上以下程式碼：

import sys
from PySide6.QtWidgets import QApplication, QLabel

app = QApplication(sys.argv)
label = QLabel("Hello World!")
label.resize(800, 600)
label.show()
app.exec()

然後在命令提示字元中執行：

python hello_world.py

成功後如下圖：

Hello World

若至此都沒問題，那這篇筆記到此告一段落。

下一篇筆記主要內容將講述：我打算做什麼樣的應用程式，以及介紹用 Qt Designer 這個圖形化工具，設計自己想要的應用程式使用者界面。

啥？ Qt Designer 又是什麼？點下一篇就知道囉。

感謝閱讀。

下一篇： [Python 練習筆記] PySide6 做一個簡單的GUI Application #1：規格與準備