HOWTO · Tkinter
安裝 Tkinter
在本教程中,我們演示如何在多個平臺上安裝 Tkinter。每個平臺在 Python 中安裝 Tkinter 都有各自的命令。
本頁內容
Tkinter 是 Python 標準庫提供的 Tk GUI 工具包介面,因此它不是 pip 可以安裝的套件:pip install tk 下載的那個 tk 套件是一個不相關的專案,並不提供這個模組。你是否已經擁有 Tkinter,取決於你的 Python 是如何安裝的——python.org 的安裝程式會捆綁它所需的 Tcl/Tk 庫,而 Linux 發行版則把這部分支援與直譯器分開打包。先檢查你實際執行的那個直譯器:
python -c "import tkinter; print(tkinter.TkVersion)"
如果它印出類似 8.6 的版本號,說明 Tkinter 可用,無需安裝任何東西。如果它以 ModuleNotFoundError: No module named 'tkinter' 失敗,請按下面對應你平臺的小節操作,然後在同一個直譯器中再次執行同一條檢查。
在 Windows 上安裝 Tkinter
python.org 的 Windows 安裝程式自帶 Tkinter 所需的 Tcl/Tk 支援。在安裝過程中,它顯示為 tcl/tk and IDLE 選項——IDLE(安裝程式附帶的編輯器)本身就是一個 Tkinter 應用程式——該選項在標準安裝中處於選取狀態,因此 python.org 的直譯器通常能通過上面的檢查。
如果現有安裝中的檢查失敗,說明這項支援在安裝時被漏掉了。重新執行你的 Python 版本對應的安裝程式(或對現有安裝使用 Modify 選項),並確保選取 tcl/tk and IDLE;Windows 上沒有單獨的 Tkinter 下載,也沒有任何 pip 命令可以補上它。
Anaconda 和 Miniconda 環境是自包含的:它們的 Python 建置包含 Tk 庫,因此 Tkinter 通常在 conda 環境中無需額外步驟即可匯入。在匯入失敗的最小化環境中,在該環境內用 conda install tk 新增這些庫,然後用該環境的直譯器重新執行檢查。
在 Linux 上安裝 Tkinter
Linux 發行版把 Tkinter 從直譯器套件中拆分出來,因此在 Linux 上安裝 Tkinter 意味著安裝一個發行版套件。套件的名稱因發行版家族而異——請使用與你所用發行版對應的命令。
在 Debian、Ubuntu 及其衍生版上,套件是 python3-tk(Debian 的套件說明指出,Tkinter 模組正是被從標準庫中拆分到這個套件裡的):
sudo apt install python3-tk
在 Fedora 上,套件是 python3-tkinter:
sudo dnf install python3-tkinter
在 Arch Linux 上,套件管理器是 pacman,Tk 工具包本身是 tk 套件——安裝它就能為系統 Python 提供其 Tkinter 模組所載入的庫:
sudo pacman -S tk
這些命令適用於發行版的 Python 3;如果你執行的是某個特定版本的直譯器,請安裝你的發行版提供的、相符的帶版本號套件(例如 Debian/Ubuntu 上的 python3.13-tk,或 Fedora 上的 python3.13-tkinter)。任何為 Python 2 寫的內容,描述的都是一個已經過時的直譯器系列,並不適用;而下載某個不相關的 tk 套件的原始碼壓縮包並執行其安裝指令碼,也不是安裝這個標準庫模組的路線。
在 macOS 上安裝 Tkinter
python.org 的 macOS 安裝程式捆綁了它自己的 Tcl/Tk,因此從 python.org 安裝的直譯器包含 Tkinter——用那個直譯器執行檢查來確認。
Homebrew 的 Python 則不同:Homebrew 在其 formula 說明中指出,tkinter 已不再包含在 python formula 之中,而是單獨提供。用以下命令安裝:
brew install python-tk
python-tk formula 跟隨目前的 Homebrew Python;如果你執行的是帶版本號的 Homebrew Python(例如 python@3.13),請安裝對應的 python-tk@3.13,讓模組落到需要它的那個直譯器裡。與 Windows 上一樣,pip 無法提供標準庫模組。
在 PyCharm 中安裝 Tkinter
PyCharm 本身不提供 Tkinter,IDE 內部也沒有任何需要為它安裝的東西:Tkinter 屬於專案所設定使用的那個 Python 直譯器。如果某個專案報告 tkinter 缺失,說明它設定的直譯器是一個沒有 Tk 支援的直譯器。
開啟專案的直譯器設定,用本文開頭的檢查針對那個直譯器執行一次——PyCharm 中該專案的 Python 主控台使用的正是同一個環境。如果檢查失敗,要修的是直譯器而不是專案:為系統直譯器安裝上面各節中對應平臺的套件,或者選擇一個能通過檢查的直譯器,例如 Windows 或 macOS 上的 python.org 直譯器,或一個 conda 環境。透過 PyCharm 的套件工具新增一個字面名為 tk 的套件,裝到的是那個不相關的 PyPI 套件,並不能修復這個匯入問題。
無論你在哪個平臺上,最後都要在你的程式碼實際將要執行的直譯器中完成驗證。Python 自帶一個 Tkinter 演示程式,正好可以兼作驗證:
python -m tkinter
用你檢查過的那個直譯器執行它:當 Tkinter 安裝正確時,它會開啟一個報告 Tcl/Tk 版本的小視窗;關閉視窗即可結束。如果匯入檢查印出了 Tk 版本,並且這個視窗能夠開啟,你的環境就已具備 Tkinter 所需的一切。