Ubuntu 上如何安装 Python 的 GUI 库

Ubuntu 上安装 Python GUI 库的常用方法

在 Ubuntu 上捣鼓 Python 图形界面开发，可选的工具库其实不少。从 Python 自带的、到通过 pip 安装的、再到系统包管理器直接搞定的，覆盖面挺广。下面把几种常见 GUI 库的安装步骤和注意事项理一理。

1. Tkinter（Python 标准 GUI 库）

Tkinter 是 Python 自带的轻量级 GUI 库，上手非常快，适合做一些工具窗口、配置面板之类的小应用。大多数 Ubuntu 发行版默认就带了，不过可以通过下面几步确认一下：

# 检查 Tkinter 是否安装（会弹出一个测试窗口）
python3 -m tkinter
# 如果没装，用 apt 安装
sudo apt update
sudo apt install python3-tk

来个小例子，看看怎么创建带标签和按钮的窗口：

import tkinter as tk
root = tk.Tk()
root.title("Tkinter 示例")
label = tk.Label(root, text="Hello, Tkinter!")
label.pack(pady=10)
button = tk.Button(root, text="点击我", command=lambda: label.config(text="按钮被点击了！"))
button.pack()
root.mainloop()

2. PyQt5/PySide6（功能强大的跨平台库）

PyQt5 是 Riverbank Computing 开发的老牌商业/开源库，组件非常丰富，表格、树形视图这些都不在话下，还带着 Qt Designer 这个可视化工具。而 PySide6 是 Qt 官方的开源替代，许可证更宽松（LGPL），用起来更省心。两者安装方式差不多：

# 通过 pip 安装 PyQt5（推荐最新版）
pip3 install --upgrade pip
pip3 install PyQt5
# 或安装 PySide6
pip3 install PySide6

PyQt5 创建主窗口的示例：

from PyQt5.QtWidgets import QApplication, QMainWindow, QLabel, QVBoxLayout, QWidget
import sys
app = QApplication(sys.argv)
window = QMainWindow()
window.setWindowTitle("PyQt5 示例")
central_widget = QWidget()
layout = QVBoxLayout()
label = QLabel("Hello, PyQt5!")
layout.addWidget(label)
central_widget.setLayout(layout)
window.setCentralWidget(central_widget)
window.show()
sys.exit(app.exec_())

3. Kivy（跨平台多点触控库）

Kivy 主要面向移动端和多点触控场景，比如手机上的小游戏、平板上的工具应用，支持 Windows、macOS、Linux、Android、iOS 等多个平台。安装起来很简单：

pip3 install kivy

看个例子，用 Kivy 创建一个带按钮的界面：

from kivy.app import App
from kivy.uix.button import Button
class MyApp(App):
    def build(self):
        return Button(text="Hello, Kivy!", size_hint=(0.5, 0.3), pos_hint={'center_x': 0.5, 'center_y': 0.5})
MyApp().run()

4. wxPython（跨平台原生界面库）

wxPython 基于 C++ 的 wxWidgets 框架，最大特点是用起来感觉像系统原生控件——Windows 上就是 Windows 的按钮，macOS 上就是 macOS 的菜单，适合做那些需要跟系统风格保持一致的应用：

# 通过 pip 安装最新版
pip3 install wxPython
# 或通过 apt 安装（版本可能会老一些）
sudo apt update
sudo apt install python3-wxgtk4.0

一段 wxPython 创建带文本框窗口的代码：

import wx
app = wx.App(False)
frame = wx.Frame(None, wx.ID_ANY, "wxPython 示例", size=(300, 200))
panel = wx.Panel(frame, wx.ID_ANY)
label = wx.StaticText(panel, wx.ID_ANY, "Hello, wxPython!", pos=(50, 50))
frame.Show(True)
app.MainLoop()

5. GTK+3（GNOME 桌面原生库）

GTK+3 是 Ubuntu GNOME 桌面的默认 GUI 工具包，PyGObject 就是它的 Python 绑定。如果你想让应用长得像 GNOME 原生应用，这是最直接的路径：

sudo apt update
sudo apt install python3-gi python3-gi-cairo gir1.2-gtk-3.0

看看怎么用 GTK+3 创建带标签的窗口：

import gi
gi.require_version('Gtk', '3.0')
from gi.repository import Gtk
class MyWindow(Gtk.Window):
    def __init__(self):
        Gtk.Window.__init__(self, title="GTK+3 示例")
        self.set_default_size(200, 100)
        label = Gtk.Label(label="Hello, GTK+3!")
        self.add(label)
win = MyWindow()
win.connect("destroy", Gtk.main_quit)
win.show_all()
Gtk.main()

安装注意事项

• 核心推荐：能用系统包管理器（比如 apt）搞定的，尽量别用 pip。像 python3-tk、python3-gi 这些，稳定性更高，后续维护也省心；
• 如果用 pip 装 PyQt5、Kivy 这类库，务必确保 Python 环境正确——强烈建议用 venv 虚拟环境，避免包冲突；
• Kivy 安装时如果提示缺少 SDL2、GStreamer 等依赖，可以用 sudo apt install python3-kivy[base,media] 来装全依赖；
• 版本兼容性也需要注意：PyQt5 这类库对 Python 版本有要求，建议用 Python 3.8 及以上版本。